Freigeben über

Migrieren vom HockeySDK zum App Center SDK für macOS

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

1.1 Alte HockeySDK entfernen

Manuell

Wenn Sie das SDK manuell hinzugefügt haben, führen Sie die folgenden Schritte aus:

  1. Entfernen Sie HockeySDK.framework den Verweis aus dem XCode-Projekt. Klicken Sie auf die Schaltfläche Verweis entfernen , und klicken Sie nicht auf In den Papierkorb verschieben .

  2. Öffnen Sie Ihre Projekteinstellungen, und entfernen Sie auf der Registerkarte Buildeinstellungen in den Abschnitten Headersuchpfade / Framework-Suchpfade die Speicherorte für Headerdateien im Zusammenhang mit HockeySDK.

  3. Öffnen Sie Ihre Projekteinstellungen, und entfernen Sie auf der Registerkarte Buildphasen im Abschnitt Binärdatei mit Bibliotheken verknüpfen die Abhängigkeitseinträge im Zusammenhang mit HockeySDK.

  4. Löschen Sie HockeySDK.framework aus dem Dateisystem.

Podfile

Wenn Sie das SDK mithilfe von CocoaPods hinzugefügt haben, entfernen Sie die pod "HockeySDK-Mac" Zeile aus der Poddatei, und führen Sie dann aus pod install.

Carthage

Wenn Sie das SDK mithilfe von Carthage hinzugefügt haben, führen Sie die folgenden Schritte aus:

  1. Entfernen Sie HockeySDK-Verweise aus dem Cartfile. Löschen Sie Cartfile.Resolved aus dem Dateisystem.

  2. Löschen Sie HockeySDK.framework und HockeySDK.framework.dSYM aus dem XCode-Projekt, und klicken Sie auf die Schaltfläche In Papierkorb verschieben .

1.2 Hinzufügen des neuen App Center SDK

Das App Center SDK unterstützt die Integration über Cocoapods, Carthage, Swift Package Manager und die Verwendung der Frameworks in Ihr Xcode-Projekt. Ausführliche Anweisungen zum Integrieren des App Center SDK finden Sie in der Dokumentation zum App Center SDK.

Hinweis

Das App Center SDK ist mit einem modularen Ansatz konzipiert, sodass Sie einen oder alle Dienste verwenden können. Sehen Sie sich die Äquivalenzen in der nächsten Tabelle an:

HockeyApp-Klasse App Center-Modul
MetricsManager Analytics
CrashManager Crashes

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

  1. Ersetzen Sie die folgenden Importe in Ihrer AppDelegate-Klasse .

    Vorher:

    @import HockeySDK;

    import HockeySDK

    Nachher:

    @import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

    import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

  2. Registrierungscode ersetzen

    Suchen Sie die didFinishLaunchingWithOptions -Methode, und ersetzen Sie HockeyApp-Codevorkommen.

    Vorher:

    [[BITHockeyManager sharedHockeyManager] configureWithIdentifier:@"APP_IDENTIFIER"];
[[BITHockeyManager sharedHockeyManager] startManager];

    BITHockeyManager.shared().configure(withIdentifier: "APP_IDENTIFIER")
BITHockeyManager.shared().start()

    Nachher:

    [MSACAppCenter start:@"{Your app secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

    AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])

  3. 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 [BITHockeyManager sharedHockeyManager].logLevel = BITLogLevelVerbose [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

Analyse

Das HockeySDK sammelt standardmäßig Metriken. Das App Center SDK sammelt standardmäßig keine (Analyse-)Metriken. Um Metriken mit dem App Center SDK zu sammeln, übergeben Sie MSACAnalytics an die start: -Methode.

Funktion HockeyApp App Center
Sitzungen automatisch nachverfolgen Standardmäßig aktiviert Dokumentation (standardmäßig aktiviert)
Benutzerdefinierte Ereignisse mit Eigenschaften Yes [MSACAnalytics trackEvent:withProperties:]
Deaktivieren des Diensts zur Laufzeit [BITHockeyManager sharedHockeyManager].disableMetricsManager = YES [MSACAnalytics setEnabled:NO]

Crashes

Das HockeySDK meldet standardmäßig Abstürze. Abstürze werden sofort an den Server gesendet, wenn die App das nächste Mal gestartet wird. Das App Center SDK meldet standardmäßig keine Abstürze. Um Abstürze mithilfe des App Center SDK zu erfassen, übergeben Sie MSACCrashes an die start: -Methode.

Funktion HockeyApp App Center
Automatisches Senden von Abstürze [[BITHockeyManager sharedHockeyManager].crashManager setAutoSubmitCrashReport: YES] Dokumentation (standardmäßig aktiviert)
Generieren eines Testabsturzes [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
Informationen zum vorherigen Absturz [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
Mach-Ausnahmebehandlung [[BITHockeyManager sharedHockeyManager].disableMachExceptionHandler = YES] Dokumentation (standardmäßig aktiviert)
Anfügen zusätzlicher Metadaten Yes Dokumentation (kann vom Delegaten angefügt werden)
Dialogfeld "Benutzer anpassen" setCrashReportUIHandler Dokumentation (standardmäßig nicht bereitgestellt)
Deaktivieren des Diensts zur Laufzeit [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled:NO]