Freigeben über

Migrieren vom HockeySDK zum App Center SDK für Cordova

  • Artikel

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.

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

1.1 Altes HockeySDK entfernen

  1. Öffnen Sie ein Terminalfenster, navigieren Sie zum Cordova-Projektordner, und führen Sie den folgenden Befehl aus:

    cordova plugin add cordova-plugin-appcenter-analytics

  2. Navigieren Sie zum Ordner Ihre App-Plattformen >> android > platform_www > Plugins , und löschen Sie cordova-plugin-hockeyapp .

1.2 Neues App Center SDK hinzufügen

Das App Center SDK ist mit einem modularen Ansatz konzipiert– Sie können nur die Dienste integrieren, an denen Sie interessiert sind. Sehen Sie sich die Äquivalenzen in der nächsten Tabelle an:

HockeyApp-Modul App Center-Modul Installationsbefehl
Crashes and Exceptions Crashes cordova plugin add cordova-plugin-appcenter-crashes
Metrics Analytics cordova plugin add cordova-plugin-appcenter-analytics

Führen Sie einen der Befehle aus, um das modul zu installieren, das Sie benötigen (oder beides).

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

Vor (HockeyApp): 00112233445566778899aabbccddeeff

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

2.2 Ersetzen der SDK-Initialisierung im Anwendungscode

  1. Entfernen Sie die HockeyApp-Initialisierung innerhalb des deviceready Handlers:

    hockeyapp.start(null, null, "APP_ID");

  2. Konfigurieren des App Center SDK

    Öffnen Sie die dateiconfig.xml des Apache Cordova-Projekts. Fügen Sie für jedes Zielelement platform Ihres Apache Cordova-Projekts (derzeit nur Android und iOS) ein untergeordnetes preference Element im folgenden Format hinzu:

    <preference name="APP_SECRET" value="{App Secret from the previous step}" />

    Weitere Informationen finden Sie in der Dokumentation zu App Center Cordova.

  3. Ersetzen Sie alle HockeyApp-API-Aufrufe in der gesamten Anwendung. Die detaillierten API-Zuordnungstabellen sind unten aufgeführt.

3. Vergleich von Diensten und Features

Core

Funktion HockeyApp App Center
Identifizieren von Benutzern hockeyapp.setUserName oder hockeyapp.setUserEmail AppCenter.setUserId

Analyse

Funktion HockeyApp App Center
Automatisches Nachverfolgen von Sitzungen Dokumentation (kann nicht deaktiviert werden) Dokumentation (standardmäßig aktiviert)
Nachverfolgen von Ereignissen hockeyapp.trackEvent Analytics.trackEvent

Crashes

Funktion HockeyApp App Center
Automatisches Senden von Abstürze autoSend-Parameter (standardmäßig deaktiviert) APPCENTER_CRASHES_ALWAYS_SEND (standardmäßig aktiviert)
Anfügen zusätzlicher Metadaten hockeyapp.addMetaData Dokumentation (kann vom Listener angefügt werden)
Generieren eines Testabsturzes hockeyapp.forceCrash AppCenter.Crashes.generateTestCrash
Anzeigen eines Dialogfelds bei Absturz ignoreDefaultHandler (standardmäßig deaktiviert, nur Android) AppCenter.Crashes.process (Rückruf bei der Verarbeitung eines Absturzes)

Versionsupdates

Der App Center-Verteilungsdienst wird im App Center Cordova SDK noch nicht unterstützt.

Feedback-Dienst

Der Feedbackdienst wird in App Center nicht unterstützt. Weitere Informationen finden Sie unter HockeyApp-Feedback.