Začínáme s Androidem
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.
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.
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.
- Otevřete soubor build.gradle na úrovni aplikace projektu (
app/build.gradle
) a zaapply plugin
př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.6'
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.
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 – onCreate
zpě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)
}
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.
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ů:
- 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>
- 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>