Wprowadzenie do systemu Android

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

Informacje o danych zbieranych przez App Center można znaleźć na stronach Zebrane dane przez SDK App Center, Ogólnego Rozporządzenia o Ochronie Danych (GDPR), oraz FAQ.

Zacznijmy od konfigurowania zestawu SDK Android App Center w swojej aplikacji, aby korzystać z usługi App Center Analytics i App Center Crashes. Aby dodać App Center Distribute do swojej aplikacji, zapoznaj się z dokumentacją App Center Distribute.

1. Wymagania wstępne

Przed rozpoczęciem upewnij się, że zostały spełnione następujące wymagania wstępne:

• Projekt Android jest skonfigurowany w programie Android Studio.
• Dotyczy to urządzeń z systemem Android w wersji 5.0 (poziom interfejsu API 21) lub nowszym.

2. Utwórz swoją aplikację w Centrum aplikacji Portalu, aby uzyskać tajny klucz 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 i kliknij przycisk Dodaj nowy w prawym górnym rogu strony, a następnie wybierz pozycję Dodaj nową aplikację z menu rozwijanego.
3. Wprowadź nazwę i opcjonalny opis aplikacji.
4. Wybierz Android jako system operacyjny i Java jako platformę.
5. Kliknij przycisk Dodaj nową aplikację .

Po utworzeniu aplikacji możesz uzyskać jej Sekret aplikacji na stronie Wprowadzenie w sekcji 2. Uruchom zestaw SDK. Możesz też kliknąć opcję Ustawienia, a następnie w prawym górnym rogu kliknąć na trzy pionowe kropki i wybrać opcję Kopiuj sekret aplikacji, aby uzyskać swój sekret aplikacji.

3. Dodawanie modułów zestawu SDK usługi App Center

1. Otwórz plik build.gradle na poziomie aplikacji projektu (app/build.gradle) i dodaj po pliku apply plugin następujące wiersze. Uwzględnij zależności, które mają zostać uwzględnione w projekcie. Każdy moduł SDK musi zostać dodany jako osobna zależność w tej sekcji. Jeśli chcesz korzystać z usług App Center Analytics i Crashes, dodaj następujące linie:

dependencies {
    def appCenterSdkVersion = '5.0.6'
    implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
    implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
}

2. Pamiętaj, aby wyzwolić synchronizację narzędzia Gradle w programie Android Studio.

Teraz, po zintegrowaniu zestawu SDK w aplikacji, nadszedł czas, aby uruchomić zestaw SDK i korzystać z Centrum aplikacji.

4. Uruchamianie zestawu SDK

4.1 Dodawanie metody start()

Aby korzystać z Centrum aplikacji, musisz wyrazić zgodę na moduły, których chcesz użyć. Domyślnie nie są uruchamiane żadne moduły i podczas uruchamiania zestawu SDK należy jawnie wywołać każde z nich.
Wstaw następujący wiersz wewnątrz głównej klasy aktywności aplikacji w onCreate-callback, aby użyć App Center Analytics i App Center Crashes:

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);

AppCenter.start(application, "{Your App Secret}", Analytics::class.java, Crashes::class.java)

Jeśli musisz uruchomić usługi App Center oddzielnie, wykonaj następujące kroki:

1. Skonfiguruj lub uruchom go przy użyciu klucza tajnego aplikacji.
2. Jeśli kod może być wywoływany wiele razy, sprawdź, czy centrum aplikacji jest już skonfigurowane.
3. Uruchom wymagane usługi bez sekretu aplikacji.

AppCenter.configure(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics.class);
    AppCenter.start(Crashes.class);
}

AppCenter.configure(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics::class.java);
    AppCenter.start(Crashes::class.java);
}

Jeśli masz więcej niż jeden punkt wejścia do aplikacji (na przykład działanie linku głębokiego, usługi lub odbiornika emisji), wywołaj klasę start niestandardową aplikacji lub w każdym punkcie wejścia. W tym drugim przypadku sprawdź, czy centrum aplikacji jest już skonfigurowane przed wywołaniem start :

if (!AppCenter.isConfigured())) {
  AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);
}

if (!AppCenter.isConfigured()) {
  AppCenter.start(application, "{Your App Secret}", Analytics::class.java, Crashes::class.java)
}

4.2 Zastąp symbol zastępczy sekretem aplikacji

Pamiętaj, aby zastąpić {Your App Secret} tekst rzeczywistą wartością aplikacji. Wpis tajny aplikacji można znaleźć na stronie Wprowadzenie lub stronie Ustawienia w portalu Centrum aplikacji.

Strona 'Pierwsze kroki' zawiera powyższy fragment kodu z twoim tajnym kluczem aplikacji. Możesz po prostu skopiować i wkleić cały przykład.

W powyższym przykładzie pokazano, jak używać start() metody i uwzględnić zarówno analizę centrum aplikacji, jak i awarie centrum aplikacji.

Jeśli nie chcesz używać jednej z dwóch usług, usuń odpowiedni parametr z powyższego wywołania metody.

Jeśli nie określisz jawnie każdego modułu jako parametrów w metodzie uruchamiania, nie możesz skorzystać z tej usługi App Center. Ponadto start() interfejs API może być używany tylko raz w cyklu życia aplikacji — wszystkie inne wywołania będą rejestrować ostrzeżenie do konsoli, a tylko moduły zawarte w pierwszym wywołaniu będą dostępne.

Na przykład — jeśli chcesz po prostu dołączyć do usługi App Center Analytics, należy zmodyfikować wywołanie interfejsu start() API w następujący sposób:

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class);

AppCenter.start(application, "{Your App Secret}", Analytics::class.java)

Android Studio automatycznie sugeruje wymagane instrukcje importu po wstawieniu metody start(), ale jeśli pojawi się błąd, że nazwy klas nie są rozpoznawane, dodaj następujące wiersze do instrukcji import w swojej klasie aktywności:

import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.analytics.Analytics;
import com.microsoft.appcenter.crashes.Crashes;

import com.microsoft.appcenter.AppCenter
import com.microsoft.appcenter.analytics.Analytics
import com.microsoft.appcenter.crashes.Crashes

Wszystko jest gotowe do wizualizacji danych analitycznych i o awariach na portalu, które zestaw SDK zbiera automatycznie.

Zapoznaj się z dokumentacją dotyczącą App Center Analytics i App Center Crashes, aby dowiedzieć się, jak dostosowywać i korzystać z bardziej zaawansowanych funkcji obu usług.

Aby dowiedzieć się, jak rozpocząć korzystanie z aktualizacji wewnątrz aplikacji, zapoznaj się z dokumentacją App Center Distribute.

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

Jeśli używasz automatycznej kopii zapasowej, aby uniknąć uzyskiwania nieprawidłowych informacji o urządzeniach, 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 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 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>