Migrieren vom HockeySDK zum App Center Android SDK

Artikel
01/16/2025

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 möglicherweise eine Migration in Erwägung ziehen.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

Befolgen Sie diese Dokumentation, wenn Sie Ihre Anwendung aktualisieren möchten, um das App Center SDK anstelle von HockeySDK zu verwenden.

1. Aktualisieren der Bibliotheken

Öffnen Sie die Datei build.gradle () auf App-Ebene des Projekts,app/build.gradle und ersetzen Sie die folgende Zeile in der dependencies { ... } Konfiguration.

Vorher:

implementation 'net.hockeyapp.android:HockeySDK:...'

Nachher:

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

Das App Center SDK ist mit einem modularen Ansatz konzipiert: Sie können nur die Dienste integrieren, die Sie interessieren. Jedes SDK-Modul muss in diesem Abschnitt als separate Abhängigkeit hinzugefügt werden. Sehen Sie sich die Äquivalenzen in der nächsten Tabelle an:

HockeyApp-Klasse	App Center-Modul
`MetricsManager`	`Analytics`
`CrashManager`	`Crashes`
`UpdateManager`	`Distribute`

2. Aktualisieren des SDK-Setupcodes

2.1 Konvertieren des Anwendungsbezeichners

Das App Center SDK verwendet Anwendungsbezeichner im GUID-Format (Globally Unique Identifier). Ihre HockeyApp App-ID kann vom App Center verwendet werden, sie muss jedoch in ein anderes Format konvertiert werden. Um den Bezeichner zu konvertieren, müssen Sie vier Bindestriche hinzufügen, um eine 8-4-4-4-12-Darstellung zu erhalten.

Vorher (HockeyApp): 00112233445566778899aabbccddeeff

Nach (App Center): 00112233-4455-6677-8899-aabbccddeeff

2.2 Ersetzen der SDK-Initialisierung im Anwendungscode

Ersetzen Sie die folgenden Importe in Ihrer Aktivitätsklasse.

Vorher:

import net.hockeyapp.android.CrashManager;
import net.hockeyapp.android.metrics.MetricsManager;
import net.hockeyapp.android.UpdateManager;

Nachher:

import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.analytics.Analytics;
import com.microsoft.appcenter.crashes.Crashes;
import com.microsoft.appcenter.distribute.Distribute;

Ersetzen Sie registrierungscode in der Standard Aktivitätsklasse Ihrer App" onCreate-callback.

Vorher:
```
CrashManager.register(this);
MetricsManager.register(getApplication());
UpdateManager.register(this);
```
Nachher:
```
AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class, Distribute.class);
```
Wenn Sie metadaten zum Bereitstellen des Anwendungsbezeichners verwendet haben, müssen Sie sie von dort in den Initialisierungscode kopieren und entfernen.
```
<meta-data android:name="net.hockeyapp.android.appIdentifier" android:value="..." />
```
aus Ihrer AndroidManifest.xml-Datei .
Ersetzen Sie HockeyApp-API-Aufrufe in der gesamten Anwendung. Die detaillierten API-Zuordnungstabellen sind unten aufgeführt.

3. Dienste- und Featurevergleich

Core

Funktion	HockeyApp	App Center
Anpassen der Protokollebene	`HockeyLog.setLogLevel`	AppCenter.setLogLevel
Identifizieren von Installationen	Nur intern	AppCenter.getInstallId
Identifizieren von Benutzern	Nur Abstürze	AppCenter.setUserId

Analyse

Funktion	HockeyApp	App Center
Sitzungen automatisch nachverfolgen	Ja, kann deaktiviert werden durch `MetricsManager.setSessionTrackingDisabled`	Dokumentation (kann nicht deaktiviert werden)
Benutzerdefinierte Ereignisse mit Eigenschaften	`MetricsManager.trackEvent`	Analytics.trackEvent
Deaktivieren des Diensts zur Laufzeit	`MetricsManager.disableUserMetrics` und `MetricsManager.enableUserMetrics`	Analytics.setEnabled

Crashes

Funktion	HockeyApp	App Center
Automatisches Senden von Abstürze	Standardmäßig deaktiviert	Dokumentation (standardmäßig aktiviert)
Anfügen zusätzlicher Metadaten	Yes	Dokumentation (kann vom Listener angefügt werden)
Dialogfeld "Benutzer anpassen"	Yes	Dokumentation (nicht standardmäßig bereitgestellt)
Abrufen von Informationen zum sendenden status	Yes	Dokumentation
Informationen zu einem vorherigen Absturz	`CrashManager.getLastCrashDetails`	Crashes.getLastSessionCrashReport

Verteilen

Hinweis

Im Gegensatz zu HockeyApp funktioniert das App Center-Feature für In-App-Updates nur mit RELEASE-Builds (standardmäßig), die mithilfe des App Center-Verteilungsdiensts verteilt werden. Wenn die App eine private Verteilergruppe verwendet, wird nach der Installation und dem ersten Öffnen der App Center Distribution SDK ein Browser geöffnet, um den Benutzer zu authentifizieren und In-App-Updates zu aktivieren. Dieser Browser wird auch geöffnet, wenn Sie den privaten In-App-Updatetrack zur Laufzeit festlegen. Dies ist ein EINMALIGEr Schritt, der für nachfolgende Versionen Ihrer App nicht ausgeführt wird. Weitere Informationen finden Sie in der Dokumentation zum Verteilen von App Center .

Funktion	HockeyApp	App Center
Eingeschränkte In-App-Updates	`LoginManager.verifyLogin`	Distribute.setUpdateTrack
Deaktivieren des Diensts zur Laufzeit	`UpdateManager.unregister`	Distribute.setEnabled
Anpassen des Dialogfelds "Update"	Yes	Dokumentation

Feedbackdienst

Der Feedbackdienst wird in App Center nicht unterstützt. Siehe HockeyApp-Feedback.

Freigeben über