Začínáme s Androidem

2025-05-05

Důležité

Visual Studio App Center bylo vyřazeno 31. března 2025 s výjimkou funkcí Analýzy a diagnostiky, které se budou dál podporovat až do 30. června 2026. Další informace.

Sada App Center SDK používá modulární architekturu, abyste mohli používat libovolnou nebo všechny služby.

Informace o datech shromážděných službou App Center najdete na stránkách s daty shromážděnými sadami SDK App Center, Obecné nařízení o ochraně dat a nejčastějšími dotazy.

Začněte nastavením App Center Android SDK ve vaší aplikaci k použití App Center Analytics a App Center Crashes. Pokud chcete do aplikace přidat distribuci App Center, podívejte se do dokumentace k distribuci App Center.

1. Požadavky

Než začnete, ujistěte se, že jsou splněny 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 (úroveň rozhraní API 21) nebo novější.

2. Vytvoření aplikace na portálu App Center pro získání tajného kódu aplikace

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

Přejděte na appcenter.ms.
Zaregistrujte se nebo se přihlaste a 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 .
Zadejte název a volitelný popis aplikace.
Jako operační systém a Javu jako platformu vyberte Android.
Klikněte na tlačítko Přidat novou aplikaci .

Jakmile vytvoříte aplikaci, můžete získat její tajný kód aplikace na stránce Začínáme pod 2. Spusťte sadu SDK. Nebo můžete kliknout na Nastavení a v pravém horním rohu kliknout na trojité 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 přidejte následující řádky za apply plugin. Zahrňte do projektu požadované závislosti. Každý modul SDK je potřeba přidat jako samostatnou závislost v této části. Pokud chcete použít App Center Analytics a Crashes, přidejte následující řádky:

dependencies {
    def appCenterSdkVersion = '5.0.6'
    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 implementation slovem compile.

Poznámka:

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

Nezapomeňte aktivovat synchronizaci Gradle v Android Studiu.

Teď, když jste integrovali sadu SDK do aplikace, je čas spustit sadu SDK a využívat 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žít. Ve výchozím nastavení nejsou spuštěny žádné moduly a při spuštění sady SDK je nutné explicitně volat jednotlivé moduly.
Vložte do hlavní třídy onCreateaktivity vaší aplikace následující řádek – zpětné volání pro použití analýzy App Center a chybového ukončení App Center:

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

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

Výstraha

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 nebo spusťte ji s App Secretem.
Pokud se kód 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á vaše aplikace více než jeden vstupní bod (například aktivitu přímého propojení, službu nebo příjemce vysílání), zavolejte start ve vlastní třídě aplikace nebo u každého vstupního bodu. V druhém případě zkontrolujte, jestli je App Center už nakonfigurovaný před voláním 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 vaší aplikace. 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 vaší aplikace. Stačí zkopírovat a vložit celou ukázku.

Výše uvedený příklad ukazuje, jak použít metodu start() a zahrnout jak analýzy App Center, tak hlášení chyb App Center.

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 start() je možné rozhraní API použít pouze jednou v životním cyklu vaší aplikace – všechna ostatní volání do konzoly zahlásí upozornění a budou k dispozici pouze moduly zahrnuté do prvního volání.

Pokud například chcete zapojit se pouze do App Center Analytics, měli byste příslušně upravit volání rozhraní API následujícím způsobem: start()

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

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

Android Studio po vložení metody automaticky navrhne požadované příkazy importu start() , 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

Jste připraveni vizualizovat data Analytics a Crashes na portálu, která sada SDK shromažďuje automaticky.

Podívejte se do dokumentace k App Center Analytics a App Center Crashes, abyste se naučili, jak přizpůsobit a používat pokročilejší funkce obou služeb.

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

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

Ve složce res/xml vytvořte soubor appcenter_backup_rule.xml.

Otevřete soubor AndroidManifest.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 souboru appcenter_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 (úroveň rozhraní API 31) nebo vyšší.

Ve složce res/xml vytvořte soubor appcenter_backup_rule.xml.

Otevřete soubor AndroidManifest.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 souboru appcenter_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>

Sdílet prostřednictvím

Začínáme s Androidem

1. Požadavky

2. Vytvoření aplikace na portálu App Center pro získání tajného kódu 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 (úroveň rozhraní API 30) nebo nižší.

5.2. Pro Android 12 (úroveň rozhraní API 31) nebo vyšší.

Váš názor

Další materiály