Začínáme s Androidem

Článek
03/15/2024

Důležité

Visual Studio App Center je naplánované k vyřazení na 31. března 2025. I když můžete Visual Studio App Center dál používat, dokud ho úplně nevyřadíte, existuje několik doporučených alternativ, na které můžete migraci zvážit.

Přečtěte si další informace o časových osách a alternativách podpory.

Sada App Center SDK používá modulární architekturu, takže můžete používat některou nebo všechny služby.

Informace o datech shromažďovaných službou App Center najdete na stránkách Věnovaném datům shromažďovaným sadami SDK služby App Center, Obecné nařízení o ochraně dat a nejčastějších dotazech .

Začněme nastavením sady App Center Android SDK ve vaší aplikaci tak, aby používala analýzy App Center a chyby app center. Pokud chcete do aplikace přidat distribuci v App Center, podívejte se do dokumentace k distribuci v App Center.

1. Požadavky

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

Váš projekt pro Android je nastavený v Android Studiu.
Cílíte na zařízení s Androidem verze 5.0 (rozhraní API úrovně 21) nebo novějším.

2. Vytvořte aplikaci na portálu App Center a získejte tajný kód aplikace.

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

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

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

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

Otevřete soubor build.gradle na úrovni aplikace projektu (app/build.gradle) a za apply pluginpřidejte následující řádky. Zahrňte závislosti, které chcete do projektu zahrnout. Každý modul SADY SDK je potřeba v této části přidat jako samostatnou závislost. Pokud chcete použít App Center Analytics a chybové ukončení, přidejte následující řádky:

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

Poznámka

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

Poznámka

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

Nezapomeňte v Android Studiu aktivovat synchronizaci Gradle.

Teď, když jste sadu SDK integrovali do 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 používat App Center, musíte se přihlásit k modulům, které chcete používat. Ve výchozím nastavení se nespouští žádné moduly a každý z nich musíte při spuštění sady SDK explicitně volat.
Vložte následující řádek do třídy hlavní aktivity vaší aplikace – onCreatezpětné volání, abyste mohli používat App Center Analytics a 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)

Upozornění

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

Pokud potřebujete spustit služby App Center samostatně, měli byste:

Nakonfigurujte ho nebo spusťte pomocí tajného kódu aplikace.
Pokud je možné kód volat vícekrát, zkontrolujte, jestli je app center už nakonfigurované.
Spusťte požadované služby bez tajného kódu 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 do aplikace více než jeden vstupní bod (například aktivitu přímého odkazu, službu nebo přijímač vysílání), zavolejte start vlastní třídu aplikace nebo v každém vstupním bodu. V druhém případě před voláním zkontrolujte, jestli je služba App Center už nakonfigurovaná 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 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 stránce Začínáme nebo na stránce Nastavení na portálu App Center.

Stránka Začínáme obsahuje 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 analýzu App Center i chybové ukončení app center.

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

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

Například pokud chcete jenom onboardovat do App Center Analytics, měli byste upravit start() volání rozhraní API následujícím způsobem:

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

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

Android Studio po vložení start() metody automaticky navrhne požadované příkazy importu, ale pokud se zobrazí chyba, že se nerozpoznaly názvy tříd, přidejte do příkazů import 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

Na portálu, který sada SDK shromažďuje automaticky, můžete vizualizovat data analýzy a chybových ukončení.

Informace o přizpůsobení a používání pokročilejších funkcí obou služeb najdete v dokumentaci k analýzám app center a chybám app center .

Informace o tom, jak začít s aktualizacemi v aplikaci, najdete v dokumentaci k distribuci v App Center.

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 získání nesprávných informací o zařízeních, postupujte podle následujících kroků:

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

Ve složce res/xml vytvořte souborappcenter_backup_rule.xml.

Otevřete souborAndroidManifest.xml projektu. android:fullBackupContent Přidejte atribut do elementu <application> . Měl by odkazovat na soubor prostředkůappcenter_backup_rule.xml .

android:fullBackupContent="@xml/appcenter_backup_rule"

Do souboruappcenter_backup_rule.xml přidejte následující pravidla 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šší.

Ve složce res/xml vytvořte souborappcenter_backup_rule.xml.

Otevřete souborAndroidManifest.xml projektu. android:dataExtractionRules Přidejte atribut do elementu <application> . Měl by odkazovat na soubor prostředkůappcenter_backup_rule.xml .

android:dataExtractionRules="@xml/appcenter_backup_rule"

Do souboruappcenter_backup_rule.xml přidejte následující pravidla 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>

Začínáme s Androidem

1. Požadavky

2. Vytvořte aplikaci na portálu App Center a získejte tajný kód aplikace.

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

4. Spuštění sady SDK

4.1 Přidání metody start()

4.2 Nahrazení zástupného symbolu tajným kódem aplikace

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

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

5.2. Pro Android 12 (rozhraní API úrovně 31) nebo vyšší.

Další materiály