Rozpocznij pracę z Unity

Zestaw SDK centrum aplikacji korzysta z architektury modułowej, dzięki czemu można używać dowolnych lub wszystkich usług.

Zacznijmy i skonfigurujmy Unity SDK App Center, aby używać App Center Analytics i Crashes. 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.

SDK App Center dla Unity obsługuje następujące platformy:

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

Aby dowiedzieć się, jak używać coroutines/callbacks z async/await zamiast .NET 3.5 backendem, zapoznaj się z sekcją Asynchroniczne interfejsy API w Unity SDK w dokumentacji.

Ponadto zestaw SDK App Center dla Unity jest dostępny tylko w języku C#.

2. Utwórz swoją aplikację w Porcie Centrum Aplikacji, aby uzyskać tajemnicę 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 zgodnie z powyższym opisem.
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ć Sekret aplikacji.

3. Dodaj zestaw SDK App Center do projektu

3a Instalowanie edytora rozszerzeń

Centrum SDK App Center jest zintegrowane poprzez importowanie pakietów Unity do Twojego projektu. W tym celu najpierw zainstaluj wtyczkę App Center Unity Editor Extensions. Otwórz rozszerzenia edytora za pomocą menu Unity: Window > App Center > i wybierz pozycję "Zainstaluj zestaw SDK App Center".

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 SDK Unity usługi App Center. Pobierz najnowszą wersję pakietów, których chcesz użyć. Nazwa powinna mieć format AppCenter{Analytics/Crashes/Distribute}-v{version}.unitypackage.

3.2b Importowanie pakietu

Otwórz projekt Unity, następnie kliknij dwukrotnie pobrany pakiet. Okno podręczne powinno pojawić się w projekcie 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, w której uruchamia się gra. Przejdź do tej sceny i dodaj pusty obiekt gry. Nadaj jej opisową nazwę, taką jak "App Center".

4.2 Dołączanie skryptu centrum aplikacji

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

4.3. Konfigurowanie ustawień centrum aplikacji

Kliknij na ten nowy obiekt "App Center" i dodaj tajne klucze 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ć

Świetnie, jesteś gotowy do wizualizacji danych analizy oraz diagnostyki (awarii i błędów) w portalu, które zestaw SDK będzie automatycznie zbierał.

Zapoznaj się z dokumentacją App Center Analytics i App Center Crashes, 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)

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 interfejsu API 30) lub niższego.

1. Utwórz plik appcenter_backup_rule.xml w folderze Assets/Plugins/Android/res/xml .

2. Otwórz plik AndroidManifest.xml projektu. android:fullBackupContent Dodaj atrybut do <application> elementu . Powinien on wskazywać plik zasobówappcenter_backup_rule.xml .

android:fullBackupContent="@xml/appcenter_backup_rule"

3. 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 .

2. 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"

3. Dodaj następujące reguły 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>