Erste Schritte mit Android

2025-05-05

Von Bedeutung

Visual Studio App Center wurde am 31. März 2025 eingestellt, mit Ausnahme der Analyse- und Diagnosefeatures, die bis zum 30. Juni 2026 weiterhin unterstützt werden. Weitere Informationen

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

Informationen zu Daten, die vom App Center gesammelt werden, finden Sie auf den Seiten zu von App Center-SDKs gesammelten Daten, den Allgemeinen Datenschutzbestimmungen und häufig gestellten Fragen.

Beginnen wir mit dem Einrichten des App Center Android SDK in Ihrer App, um App Center Analytics und App Center Crashes zu verwenden. Wenn Sie Ihrer App App Center Verteilen hinzufügen möchten, sehen Sie sich die Dokumentation für App Center Distribute an.

1. Voraussetzungen

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

Ihr Android-Projekt ist in Android Studio eingerichtet.
Sie richten sich an Geräte mit Android Version 5.0 (API-Ebene 21) oder höher.

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.
Melden Sie sich an, und klicken Sie in der oberen rechten Ecke der Seite auf die Schaltfläche " Neue Hinzufügen ", und wählen Sie im Dropdownmenü " 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 das App-Geheimnis auf der Seite " Erste Schritte " unter 2 abrufen. Starten Sie das SDK. Alternativ können Sie auf "Einstellungen" und in der oberen rechten Ecke auf die dreifachen vertikalen Punkte klicken und " App-Geheimnis kopieren" auswählen, um ihren App-Geheimen Schlüssel zu erhalten.

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 plugin. 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 Crashes verwenden möchten, fügen Sie die folgenden Zeilen hinzu:

dependencies {
    def appCenterSdkVersion = '5.0.6'
    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 die Wortimplementierung durch Kompilieren ersetzen.

Hinweis

Aufgrund der Beendigung der jCenter-Unterstützung wurden alle unsere Assemblys in das Maven Central Repository verschoben. Bitte folgen Sie diesem Leitfaden zur Migration von jCenter nach Maven Central. Bitte 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 zu verwenden, müssen Sie sich für die module(n) anmelden, die Sie verwenden möchten. Standardmäßig werden keine Module gestartet, und sie müssen beim Starten des SDK explizit aufgerufen werden.
Fügen Sie die folgende Zeile in das onCreate-Callback der Hauptaktivitätsklasse Ihrer App ein, um App Center Analytics und App Center Crashes 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, Den Geheimen App-Schlüssel in Quellcode einzubetten.

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

Konfigurieren oder starten Sie es mit dem Geheimen App-Schlüssel.
Wenn der Code mehrmals aufgerufen werden kann, überprüfen Sie, ob das App Center bereits konfiguriert ist.
Starten Sie die erforderlichen Dienste ohne den App-Geheimschlüssel.

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 mehr als einen Einstiegspunkt zu Ihrer Anwendung haben (z. B. eine Deep-Link-Aktivität, einen Dienst oder einen Übertragungsempfänger), rufen Sie start in der benutzerdefinierten Klasse der Anwendung oder in jedem Einstiegspunkt auf. Überprüfen Sie im letzten 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 Ihren App-Geheimschlüssel.

Stellen Sie sicher, dass Sie den Text {Your App Secret} durch den tatsächlichen Wert für Ihre Anwendung ersetzen. Das App-Geheimnis befindet sich 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-Geheimschlüssel darin. Sie können einfach das gesamte Beispiel kopieren.

Im obigen Beispiel wird gezeigt, 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.

Sofern Sie nicht jedes Modul explizit als Parameter in der Startmethode 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 an der Konsole, und nur die module, die im ersten Aufruf enthalten sind, sind verfügbar.

Beispiel: Wenn Sie nur app Center Analytics integrieren 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, nachdem Sie die start() Methode eingefügt haben. Wenn jedoch ein Fehler angezeigt wird, dass die Klassennamen nicht erkannt werden, fügen Sie die folgenden Zeilen zu den Importanweisungen in Ihrer Aktivitätsklasse 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

Jetzt können Sie auf dem Portal die Analytics- und Crash-Daten visualisieren, die das SDK automatisch zur Verfügung stellt.

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

Wenn Sie erfahren möchten, wie Sie mit In-App-Updates beginnen, lesen Sie die Dokumentation von App Center Distribute.

5. Sicherungsregeln (nur Android)

Hinweis

Apps für Android 6.0 (API-Ebene 23) oder höher haben automatisch die automatische Sicherung 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 Informationen zu Geräten zu vermeiden, führen Sie die folgenden 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 das android:fullBackupContent Attribut dem <application> Element 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 das android:dataExtractionRules Attribut dem <application> Element 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>

Freigeben über

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 Ihren App-Geheimschlüssel.

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.

Feedback

Zusätzliche Ressourcen