Začínáme s Androidem

Sada App Center SDK používá modulární architekturu, takže můžete použít libovolné nebo všechny služby.

Informace o datech shromažďovaných App Center najdete na stránkách shromažďovaných App Center SDK, Obecné nařízení o ochraně osobních údajů a nejčastějšími dotazy.

Začátečněme s nastavením App Center Android SDK ve vaší aplikaci pro použití App Center Analytics a App Center selhání. Pokud chcete App Center distribuovat do vaší aplikace, podívejte se na dokumentaci k App Center distribuovat.

1. Požadavky

Než začnete, ujistěte se, že jsou splněné následující požadavky:

  • Projekt pro Android je nastavený v Android Studio.
  • Cílíte na zařízení se systémem Android verze 5.0 (úroveň rozhraní API 21) nebo novějším.

2. Vytvoření aplikace na App Center Portal k získání tajného klíče aplikace

Pokud jste už aplikaci vytvořili na portálu App Center Portal, můžete tento krok přeskočit.

  1. Zamiste na appcenter.ms.
  2. Zaregistrujte se nebo se přihlaste, klikněte na tlačítko Přidat nový v pravém horním rohu stránky a v rozevírací nabídce vyberte Přidat novou aplikaci.
  3. Zadejte název a volitelný popis aplikace.
  4. Jako operační systém vyberte Android a jako platformu vyberte Java.
  5. Klikněte na tlačítko Přidat novou aplikaci.

Po vytvoření aplikace můžete její tajný kód aplikace získat na stránce Začínáme2. Spusťte sadu SDK. Nebo můžete kliknout na Nastavení v pravém horním rohu kliknout na tři svislé tečky a vybrat Kopírovat tajný kód aplikace a získat tajný kód aplikace.

3. Přidání modulů App Center SDK

  1. Otevřete soubor build.gradle na úrovni aplikace projektu (app/build.gradle) a za přidejte následující řádky apply plugin. Zahrnte do projektu závislosti, které chcete mít. Každý modul SADY SDK je v této části potřeba přidat jako samostatnou závislost. Pokud chcete použít App Center Analytics a Crashes, přidejte následující řádky:
dependencies {
    def appCenterSdkVersion = '4.1.0'
    implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
    implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
}

Poznámka

Pokud je verze modulu plug-in Android Gradle nižší než 3.0.0, musíte nahradit slovo implementacekompilací.

Poznámka

Kvůli ukončení podpory jCenter se všechna naše sestavení přesunula do centrálního úložiště Maven. Postupujte podle tohoto průvodce migrací z jCenter do Centra Mavenu. Upozorňujeme, že Maven Central neobsahuje zastaralé moduly. Ujistěte se, že váš projekt nemá závislosti zastaralých modulů App Center SDK.

  1. Nezapomeňte aktivovat synchronizaci Gradlu v Android Studio.

Teď, když máte sadu SDK integrovanou do své aplikace, je čas spustit sadu SDK a využít App Center.

4. Spuštění sady SDK

4.1 Přidání metody start()

Pokud chcete App Center, musíte se přihlásit k modulům, které chcete použít. Ve výchozím nastavení nejsou spuštěny žádné moduly a při spuštění sady SDK je nutné je explicitně volat.
Do zpětného volání onCreatehlavní třídy aktivity vaší aplikace vložte následující řádek, aby se App Center Analytics a App Center chyb:

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

Upozornění

Tajný kód aplikace se nedoporučuje vkládat do zdrojového kódu.

Pokud potřebujete začít s App Center službami samostatně, měli byste:

  1. Nakonfigurujte nebo spusťte tajný klíč aplikace.
  2. Pokud lze kód volat vícekrát, zkontrolujte, jestli App Center konfigurace.
  3. Spusťte požadované služby bez tajného klíče aplikace.
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);
}

Pokud máte k aplikaci více než jeden vstupní bod (například aktivitu přímého propojení, službu nebo přijímač všesměrového vysílání), zavolejte start ve vlastní třídě aplikace nebo v každém vstupním bodě. V druhém případě zkontrolujte, jestli App Center před voláním start už nakonfigurovaná konfigurace:

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 Nahrazení zástupného symbolu tajným kódem aplikace

Nezapomeňte nahradit {Your App Secret} text skutečnou hodnotou pro vaši aplikaci. Tajný kód aplikace najdete na Začínáme neboNastavení na App Center Portal.

Stránka Začínáme výše uvedenou ukázku kódu s tajným kódem aplikace, stačí zkopírovat a vložit celou ukázku.

Výše uvedený příklad ukazuje, jak použít metodu start() a zahrnout jak App Center Analytics, tak App Center selhání.

Pokud nechcete použít jednu ze dvou služeb, odeberte odpovídající parametr z výše uvedeného volání metody.

Pokud explicitně nezadáte jednotlivé moduly jako parametry v metodě start, nemůžete tuto službu App Center použít. Kromě toho je start() možné rozhraní API použít pouze jednou v životním cyklu aplikace – všechna ostatní volání budou protokolovat upozornění do konzoly a budou k dispozici pouze moduly zahrnuté v prvním volání.

Pokud chcete například ke službě App Center Analytics jenom onboardovat, start() měli byste volání rozhraní API upravit následujícím způsobem:

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

start() Android Studio po vložení metody automaticky navrhne požadované příkazy importu, ale pokud se zobrazí chyba, že názvy tříd nejsou rozpoznány, přidejte do příkazů importu ve třídě aktivity následující řádky:

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

Všechny jsou nastavené tak, aby vizualizovat data Analýzy a Selhání na portálu, která sada SDK shromažďuje automaticky.

Podívejte se do dokumentace k App Center Analytics a App Center, kde se dozvíte, jak přizpůsobit a využívat pokročilejší funkce obou služeb.

Pokud chcete zjistit, jak začít s aktualizacemi v aplikaci, přečtěte si dokumentaci k App Center distribuci.

5. Pravidla zálohování (jenom Android)

Poznámka

Aplikace, které cílí na Android 6.0 (úroveň rozhraní API 23) nebo vyšší, mají automatické zálohování povolené automaticky. 

Poznámka

Pokud už máte vlastní soubor s pravidlem zálohování, přepněte na třetí krok.

Pokud používáte automatické zálohování, abyste se vyhnuli nesprávným informacím o zařízeních, postupujte následovně:

5.1. Pro Android 11 (úroveň rozhraní API 30) nebo nižší.

  1. Vytvořte appcenter_backup_rule.xml ve složce res/xml .
  1. Otevřete souborAndroidManifest.xmlprojektu . Přidejte android:fullBackupContent atribut do <application> elementu . Měl by odkazovat na appcenter_backup_rule.xml prostředku.
android:fullBackupContent="@xml/appcenter_backup_rule"
  1. Do tohoto souboru přidejte následujícíappcenter_backup_rule.xml zálohování:
<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. Pro Android 12 (rozhraní API úrovně 31) nebo vyšší.

  1. Vytvořte appcenter_backup_rule.xml ve složce res/xml .
  1. Otevřete souborAndroidManifest.xmlprojektu . Přidejte android:dataExtractionRules atribut do <application> elementu . Měl by odkazovat na appcenter_backup_rule.xml prostředku.
android:dataExtractionRules="@xml/appcenter_backup_rule"
  1. Do tohoto souboru přidejte následujícíappcenter_backup_rule.xml zálohování:
<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>