Wprowadzenie do aparatu Unity

  • Artykuł

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Mimo że możesz nadal używać programu Visual Studio App Center do momentu jej pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

Zestaw SDK centrum aplikacji korzysta z architektury modułowej, aby można było używać dowolnych lub wszystkich usług.

Zacznijmy i skonfigurujmy zestaw SDK aparatu Unity usługi App Center do korzystania z usługi App Center Analytics i awarii. Aby dodać usługę App Center Distribute do aplikacji, zobacz dokumentację dotyczącą dystrybucji centrum aplikacji.

1. Wymagania wstępne

Przed rozpoczęciem upewnij się, że projekt został skonfigurowany w środowisku Unity 2018.1 lub nowszym.

Zestaw SDK usługi App Center dla aparatu Unity obsługuje następujące platformy:

  • iOS (wersja 9.0 lub nowsza)
  • Android (5.0/API 21 lub nowszy)
  • Platforma UWP (kompilacja 16299 lub nowsza)

Uwaga

Wersja środowiska uruchomieniowego skryptów platformy .NET 3.5 i zaplecze skryptów platformy .NET nie są już obsługiwane na platformie UWP.

Aby dowiedzieć się, jak używać coroutines/callbacks zamiast async/await z zapleczem, zapoznaj się z .NET 3.5asynchronicznymi interfejsami API w sekcji Zestaw SDK aparatu Unity w dokumentacji.

Ponadto zestaw SDK centrum aplikacji dla aparatu Unity jest dostępny tylko w języku C#.

2. Tworzenie aplikacji w portalu Centrum aplikacji w celu uzyskania wpisu tajnego aplikacji

Jeśli aplikacja została już utworzona w portalu Centrum aplikacji, możesz pominąć ten krok.

  1. Przejdź do appcenter.ms.
  2. Zarejestruj się lub zaloguj się do Centrum aplikacji.
  3. Kliknij niebieski przycisk w prawym górnym rogu portalu z komunikatem Dodaj nową i wybierz pozycję Dodaj nową aplikację z menu rozwijanego.
  4. Wprowadź nazwę i opcjonalny opis aplikacji.
  5. Wybierz odpowiedni system operacyjny i platformę w zależności od projektu, jak opisano powyżej.
  6. Kliknij przycisk Dodaj nową aplikację w prawym dolnym rogu strony.

Po utworzeniu aplikacji możesz uzyskać jej wpis tajny aplikacji na stronie Ustawienia w portalu Centrum aplikacji. W prawym górnym rogu strony Ustawienia kliknij potrójne kropki pionowe i wybierz, Copy app secret aby uzyskać wpis tajny aplikacji.

3. Dodawanie zestawu SDK centrum aplikacji do projektu

3a Instalowanie Redaktor rozszerzenia

Zestaw SDK centrum aplikacji jest zintegrowany przez zaimportowanie pakietów Aparatu Unity do projektu. W tym celu najpierw zainstaluj wtyczkę Unity Redaktor Extensions usługi App Center. Otwórz rozszerzenia Redaktor za pomocą menu aparatu Unity: Windows > App Center > Redaktor Extensions i wybierz pozycję "Zainstaluj zestaw SDK centrum aplikacji".

Uwaga

W środowiskach Unity w wersji 2019.1.2f1 i nowszych mogą występować błędy w dziennikach podczas instalacji, takich jak Coroutine continue failure. Jest to znany problem z aparatem Unity i należy go zignorować.

3.1b Instalowanie pojedynczych pakietów

Alternatywnie każdy z poszczególnych pakietów Unity można pobrać i zaimportować. Znajdują się one na stronie GitHub zestawu SDK aparatu Unity usługi App Center. Pobierz najnowszą wersję pakietów, których chcesz użyć. Jego nazwa powinna być w formacie AppCenter{Analytics/Crash/Distribute}-v{version}.unitypackage.

3.2b Importowanie pakietu

Otwórz projekt aparatu Unity, a następnie kliknij dwukrotnie pobrany pakiet. Okno podręczne powinno pojawić się w projekcie aparatu Unity zawierającym listę plików. Wybierz pozycję Importuj, a zestaw SDK zostanie dodany do projektu. Powtórz ten krok dla każdego pobranego pakietu i zaplanuj użycie go w projekcie.

4. Włączanie zestawu SDK

4.1 Tworzenie pustego obiektu gry

Usługa App Center działa jako składnik dołączany do obiektu gry w scenie uruchamianej przez grę. Przejdź do tej sceny i dodaj pusty obiekt gry. Nadaj mu opisową nazwę, taką jak "App Center".

4.2 Dołączanie skryptu centrum aplikacji

W oknie Projekt przejdź do folderu "AppCenter", który został dodany do projektu. Znajdź skrypt o nazwie AppCenterBehavior i przeciągnij go do nowo utworzonego obiektu gry w oknie Hierarchia .

Uwaga

Nie musisz dodawać centrum aplikacji do każdej sceny, w której chcesz jej używać. Dodanie jej do pierwszej załadowanej sceny jest wystarczające.

4.3 Konfigurowanie ustawień centrum aplikacji

Kliknij ten nowy obiekt "App Center" i dodaj wpisy tajne aplikacji do odpowiednich pól w oknie Inspektor . Pamiętaj również, aby zaznaczyć pola "Użyj usługi {service}" dla każdej usługi App Center, której zamierzasz użyć

Konfiguracja programu App Center skryptu

Ostrzeżenie

Nie zaleca się osadzania wpisu tajnego aplikacji w kodzie źródłowym.

Uwaga

Jeśli projekt nie obsługuje jednej z trzech platform wymienionych w ustawieniach, pozostaw pole wpisu tajnego aplikacji tak, jak to jest; to nie będzie miało wpływu. Jeśli projekt obsługuje platformy, które centrum aplikacji nie obsługuje, interfejsy API i konfiguracja nie będą miały wpływu na te platformy.

Wszystko jest gotowe do wizualizacji danych analizy i diagnostyki (awarii i błędu) w portalu, które zestaw SDK będzie automatycznie zbierać.

Zapoznaj się z dokumentacją dotyczącą awarii usługi App Center Analytics i App Center , aby dowiedzieć się, jak korzystać z bardziej zaawansowanych funkcji w obu usługach.

Aby dowiedzieć się, jak rozpocząć pracę z aktualizacjami w aplikacji, przeczytaj dokumentację dotyczącą dystrybucji centrum aplikacji.

5. Reguły tworzenia kopii zapasowych (tylko system Android)

Uwaga

Aplikacje przeznaczone dla systemu Android 6.0 (poziom 23 interfejsu API) lub nowsze mają automatycznie włączoną automatyczną kopię zapasową.

Uwaga

Jeśli masz już plik niestandardowy z regułą tworzenia kopii zapasowej, przejdź do trzeciego kroku.

Uwaga

Jeśli nie masz jeszcze własnego pliku AndroidManifest.xml , utwórz go w folderze Assets/Plugins/Android . Ten manifest zostanie scalony z domyślnym utworzonym aparatem Unity podczas kompilacji.

Jeśli używasz automatycznej kopii zapasowej, aby uniknąć uzyskiwania nieprawidłowych informacji o urządzeniu, wykonaj następujące kroki:

5.1. W przypadku systemu Android 11 (poziom 30 interfejsu API) lub niższego.

  1. Utwórz plikappcenter_backup_rule.xml w folderze Assets/Plugins/Android/res/xml .
  1. Otwórz plik AndroidManifest.xml projektu. android:fullBackupContent Dodaj atrybut do <application> elementu. Powinien wskazywać appcenter_backup_rule.xml plik zasobu.
android:fullBackupContent="@xml/appcenter_backup_rule"
  1. Dodaj następujące reguły kopii zapasowej do pliku appcenter_backup_rule.xml :
<full-backup-content xmlns:tools="http://schemas.android.com/tools">
      <exclude domain="sharedpref" path="AppCenter.xml"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
      <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
      <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
  </full-backup-content>

5.2. W przypadku systemu Android 12 (poziom interfejsu API 31) lub nowszego.

  1. Utwórz plik appcenter_backup_rule.xml w folderze Assets/Plugins/Android/res/xml .
  1. Otwórz plik AndroidManifest.xml projektu. android:dataExtractionRules Dodaj atrybut do <application> elementu . Powinien on wskazywać plik zasobówappcenter_backup_rule.xml .
android:dataExtractionRules="@xml/appcenter_backup_rule"
  1. Dodaj następujące reguły tworzenia kopii zapasowej do pliku appcenter_backup_rule.xml :
<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </device-transfer>
</data-extraction-rules>