Erste Schritte mit Android

Artikel
12/11/2023

Wichtig

Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie eine Migration in Betracht ziehen können.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

Das App Center SDK verwendet eine modulare Architektur, sodass Sie beliebige oder alle Dienste verwenden können.

Informationen zu den von App Center gesammelten Daten finden Sie auf den Von App Center-SDKs gesammelten Daten, der Datenschutz-Grundverordnung und den Faq-Seiten.

Beginnen wir mit dem Einrichten des App Center Android SDK in Ihrer App für die Verwendung von App Center Analytics und App Center-Abstürze. Informationen zum Hinzufügen von App Center Distribute zu Ihrer App finden Sie in der Dokumentation zu App Center Distribute.

1. Voraussetzungen

Stellen Sie zunächst sicher, dass die folgenden Voraussetzungen erfüllt sind:

Ihr Android-Projekt wird in Android Studio eingerichtet.
Sie zielen auf Geräte ab Android Version 5.0 (API-Ebene 21) ab.

2. Erstellen Sie Ihre App im App Center-Portal, um das App-Geheimnis zu erhalten.

Wenn Sie Ihre App bereits im App Center-Portal erstellt haben, können Sie diesen Schritt überspringen.

Wechseln Sie zu appcenter.ms.
Registrieren Sie sich, oder melden Sie sich an, klicken Sie in der oberen rechten Ecke der Seite auf die Schaltfläche Neu hinzufügen , und wählen Sie im Dropdownmenü die Option Neue App hinzufügen aus.
Geben Sie einen Namen und eine optionale Beschreibung für Ihre App ein.
Wählen Sie Android als Betriebssystem und Java als Plattform aus.
Klicken Sie auf die Schaltfläche Neue App hinzufügen .

Nachdem Sie eine App erstellt haben, können Sie ihr App-Geheimnis auf der Seite Erste Schritte unter 2 abrufen. Starten Sie das SDK. Alternativ können Sie auf Einstellungen klicken, und klicken Sie oben rechts auf die dreifachen vertikalen Punkte , und wählen Sie App-Geheimnis kopieren aus, um Ihr App-Geheimnis abzurufen.

3. Hinzufügen der App Center SDK-Module

Öffnen Sie die Datei build.gradle (app/build.gradle) auf App-Ebene des Projekts, und fügen Sie die folgenden Zeilen nach apply pluginhinzu. Schließen Sie die gewünschten Abhängigkeiten in Ihr Projekt ein. Jedes SDK-Modul muss in diesem Abschnitt als separate Abhängigkeit hinzugefügt werden. Wenn Sie App Center Analytics und Abstürze verwenden möchten, fügen Sie die folgenden Zeilen hinzu:

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

Hinweis

Wenn die Version Ihres Android Gradle-Plug-Ins niedriger als 3.0.0 ist, müssen Sie das Wort Implementierung durch kompilieren ersetzen.

Hinweis

Aufgrund der Beendigung der jCenter-Unterstützung wurden alle unsere Assemblys in das Maven Central-Repository verschoben. Befolgen Sie diesen Leitfaden zur Migration von jCenter zu Maven Central. Beachten Sie, dass Maven Central keine veralteten Module enthält. Stellen Sie sicher, dass Ihr Projekt keine Abhängigkeiten von veralteten App Center SDK-Modulen aufweist.

Stellen Sie sicher, dass Sie eine Gradle-Synchronisierung in Android Studio auslösen.

Nachdem Sie das SDK in Ihre Anwendung integriert haben, ist es an der Zeit, das SDK zu starten und App Center zu verwenden.

4. Starten des SDK

4.1 Hinzufügen der start()-Methode

Um App Center verwenden zu können, müssen Sie sich für die Module entscheiden, die Sie verwenden möchten. Standardmäßig werden keine Module gestartet, und Sie müssen diese beim Starten des SDK explizit aufrufen.
Fügen Sie die folgende Zeile in die Standard Aktivitätsklasse Ihrer App ein: onCreateRückruf, um App Center Analytics und App Center-Abstürze zu verwenden:

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

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

Warnung

Es wird nicht empfohlen, Ihr App-Geheimnis in den Quellcode einzubetten.

Wenn Sie App Center-Dienste separat starten müssen, sollten Sie:

Konfigurieren oder starten Sie sie mit dem App-Geheimnis.
Wenn der Code mehrmals aufgerufen werden kann, überprüfen Sie, ob das App Center bereits konfiguriert ist.
Starten Sie die erforderlichen Dienste ohne das App-Geheimnis.

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);
}

Wenn Sie über mehr als einen Einstiegspunkt zu Ihrer Anwendung verfügen (z. B. eine Deep Link-Aktivität, einen Dienst oder einen Broadcastempfänger), rufen Sie start in der benutzerdefinierten Anwendungsklasse oder in jedem Einstiegspunkt auf. Überprüfen Sie im letzteren Fall, ob App Center bereits vor dem start Aufruf konfiguriert ist:

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 Ersetzen Sie den Platzhalter durch Ihr App-Geheimnis.

Stellen Sie sicher, dass Text durch den tatsächlichen Wert für Ihre Anwendung ersetzt {Your App Secret} wird. Das App-Geheimnis finden Sie auf der Seite Erste Schritte oder auf der Seite Einstellungen im App Center-Portal.

Die Seite Erste Schritte enthält das obige Codebeispiel mit Ihrem App-Geheimnis. Sie können einfach das gesamte Beispiel kopieren und einfügen.

Das obige Beispiel zeigt, wie Sie die start() -Methode verwenden und sowohl App Center Analytics als auch App Center-Abstürze einschließen.

Wenn Sie keinen der beiden Dienste verwenden möchten, entfernen Sie den entsprechenden Parameter aus dem obigen Methodenaufruf.

Wenn Sie jedes Modul nicht explizit als Parameter in der start-Methode angeben, können Sie diesen App Center-Dienst nicht verwenden. Darüber hinaus kann die start() API nur einmal im Lebenszyklus Ihrer App verwendet werden. Alle anderen Aufrufe protokollieren eine Warnung in der Konsole, und nur die module, die im ersten Aufruf enthalten sind, sind verfügbar.

Beispiel: Wenn Sie nur ein Onboarding in App Center Analytics durchführen möchten, sollten Sie den start() API-Aufruf wie folgt ändern:

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

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

Android Studio schlägt automatisch die erforderlichen Importanweisungen vor, sobald Sie die start() -Methode eingefügt haben. Wenn jedoch ein Fehler angezeigt wird, dass die Klassennamen nicht erkannt werden, fügen Sie den Importanweisungen in Ihrer Aktivitätsklasse die folgenden Zeilen hinzu:

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

Sie alle können Analyse- und Absturzdaten im Portal visualisieren, die das SDK automatisch erfasst.

Sehen Sie sich die Dokumentation für App Center Analytics und App Center-Abstürze an, um zu erfahren, wie Sie erweiterte Funktionen beider Dienste anpassen und verwenden.

Informationen zu den ersten Schritten mit In-App-Updates finden Sie in der Dokumentation von App Center Distribute.

5. Sicherungsregeln (nur Android)

Hinweis

Für Apps mit Android 6.0 (API-Ebene 23) oder höher ist die automatische Sicherung automatisch aktiviert.

Hinweis

Wenn Sie bereits über eine benutzerdefinierte Datei mit Sicherungsregel verfügen, wechseln Sie zum dritten Schritt.

Wenn Sie die automatische Sicherung verwenden, um falsche Geräteinformationen zu vermeiden, führen Sie die nächsten Schritte aus:

5.1. Für Android 11 (API-Ebene 30) oder niedriger.

Erstellen Sie appcenter_backup_rule.xml Datei im Ordner res/xml .

Öffnen Sie die AndroidManifest.xml Datei des Projekts. Fügen Sie dem -Element das android:fullBackupContent<application> -Attribut hinzu. Sie sollte auf die appcenter_backup_rule.xml-Ressourcendatei verweisen.

android:fullBackupContent="@xml/appcenter_backup_rule"

Fügen Sie der dateiappcenter_backup_rule.xml die folgenden Sicherungsregeln hinzu:

<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. Für Android 12 (API-Ebene 31) oder höher.

Erstellen Sie appcenter_backup_rule.xml Datei im Ordner res/xml .

Öffnen Sie die AndroidManifest.xml Datei des Projekts. Fügen Sie dem -Element das android:dataExtractionRules<application> -Attribut hinzu. Sie sollte auf die appcenter_backup_rule.xml-Ressourcendatei verweisen.

android:dataExtractionRules="@xml/appcenter_backup_rule"

Fügen Sie der dateiappcenter_backup_rule.xml die folgenden Sicherungsregeln hinzu:

<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>

Erste Schritte mit Android

1. Voraussetzungen

2. Erstellen Sie Ihre App im App Center-Portal, um das App-Geheimnis zu erhalten.

3. Hinzufügen der App Center SDK-Module

4. Starten des SDK

4.1 Hinzufügen der start()-Methode

4.2 Ersetzen Sie den Platzhalter durch Ihr App-Geheimnis.

5. Sicherungsregeln (nur Android)

5.1. Für Android 11 (API-Ebene 30) oder niedriger.

5.2. Für Android 12 (API-Ebene 31) oder höher.

Zusätzliche Ressourcen