Udostępnij za pośrednictwem

Migrowanie z zestawu HockeySDK do zestawu SDK usługi App Center dla systemu macOS

  • Artykuł

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Mimo że możesz nadal używać programu Visual Studio App Center do momentu jej pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

Postępuj zgodnie z tą dokumentacją, jeśli chcesz zaktualizować aplikację do używania zestawu SDK centrum aplikacji zamiast zestawu HockeySDK.

1. Aktualizowanie bibliotek

1.1 Usuwanie starego hokejaSDK

Ręcznie

Jeśli zestaw SDK został dodany ręcznie, wykonaj następujące kroki:

  1. Usuń HockeySDK.framework odwołanie z projektu XCode. Kliknij przycisk Usuń odwołanie , nie klikaj przycisku Przenieś do kosza .

  2. Otwórz ustawienia projektu i na karcie Ustawienia kompilacji w sekcjach Ścieżki wyszukiwania struktur wyszukiwania nagłówków / usuń lokalizacje plików nagłówkowych związanych z hockeySDK.

  3. Otwórz ustawienia projektu i na karcie Fazy kompilacji w sekcji Łączenie pliku binarnego z bibliotekami usuń wpisy zależności związane z hokejaSDK.

  4. Usuń HockeySDK.framework z systemu plików.

Podfile

Jeśli zestaw SDK został dodany przy użyciu narzędzia CocoaPods, usuń pod "HockeySDK-Mac" wiersz z pliku Podfile, a następnie uruchom polecenie pod install.

Kartagina

Jeśli zestaw SDK został dodany przy użyciu narzędzia Carthage, wykonaj następujące kroki:

  1. Usuń odwołania hockeySDK z elementu Cartfile. Usuń Cartfile.Resolved z systemu plików.

  2. Usuń HockeySDK.framework i HockeySDK.framework.dSYM z projektu XCode i kliknij przycisk Przenieś do kosza .

1.2 Dodawanie nowego zestawu SDK centrum aplikacji

Zestaw SDK centrum aplikacji obsługuje integrację za pośrednictwem platform Cocoapods, Carthage, Swift Package Manager i korzystania z platform w projekcie Xcode. Zapoznaj się ze szczegółowymi instrukcjami dotyczącymi sposobu integrowania zestawu SDK centrum aplikacji w dokumentacji zestawu SDK centrum aplikacji.

Uwaga

Zestaw SDK centrum aplikacji został zaprojektowany z modułowym podejściem, dzięki czemu można używać dowolnych lub wszystkich usług. Zobacz równoważności w następnej tabeli:

HockeyApp, klasa Moduł Centrum aplikacji
MetricsManager Analytics
CrashManager Crashes

2. Aktualizowanie kodu konfiguracji zestawu SDK

2.1 Konwertowanie identyfikatora aplikacji

Zestaw SDK centrum aplikacji używa identyfikatorów aplikacji w formacie globalnie unikatowego identyfikatora (GUID). Identyfikator aplikacji HockeyApp może być używany przez centrum aplikacji, ale musisz przekonwertować go na inny format. Aby przekonwertować identyfikator, należy dodać cztery łączniki, aby uzyskać reprezentację 8-4-4-4-12.

Przed (HockeyApp): 00112233445566778899aabbccddeeff

Po (Centrum aplikacji): 00112233-4455-6677-8899-aabbccddeeff

2.2 Zastąp inicjowanie zestawu SDK w kodzie aplikacji

  1. Zastąp następujące importy w klasie AppDelegate .

    Przed:

    @import HockeySDK;

    import HockeySDK

    Po:

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

    import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

  2. Zastąp kod rejestracji

    Znajdź metodę i zastąp didFinishLaunchingWithOptions wystąpienia kodu HockeyApp.

    Przed:

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

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

    Po:

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

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

  3. Zastąp wywołania interfejsu API HockeyApp w całej aplikacji. Poniżej podano szczegółowe tabele mapowania interfejsu API.

3. Porównanie usług i funkcji

Core

Cecha HockeyApp App Center
Dostosowywanie poziomu dziennika [BITHockeyManager sharedHockeyManager].logLevel = BITLogLevelVerbose [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

Analiza

Zestaw HockeySDK zbiera metryki na wartość domyślną. Zestaw SDK centrum aplikacji nie zbiera żadnych metryk (analizy) na wartość domyślną. Aby zebrać metryki przy użyciu zestawu SDK centrum aplikacji, przekaż MSACAnalytics do start: metody .

Cecha HockeyApp App Center
Automatyczne śledzenie sesji Domyślnie włączone Dokumentacja (domyślnie włączona)
Zdarzenia niestandardowe z właściwościami Tak [MSACAnalytics trackEvent:withProperties:]
Wyłączanie usługi w czasie wykonywania [BITHockeyManager sharedHockeyManager].disableMetricsManager = YES [MSACAnalytics setEnabled:NO]

Ulega awarii

Raporty HockeySDK zgłasza awarie na wartość domyślną. Awarie zostaną natychmiast wysłane na serwer przy następnym uruchomieniu aplikacji. Zestaw SDK centrum aplikacji nie zgłasza żadnych awarii na wartość domyślną. Aby zebrać awarie przy użyciu zestawu SDK centrum aplikacji, przekaż MSACCrashes do start: metody .

Cecha HockeyApp App Center
Automatyczne wysyłanie awarii [[BITHockeyManager sharedHockeyManager].crashManager setAutoSubmitCrashReport: YES] Dokumentacja (domyślnie włączona)
Generowanie awarii testowej [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
Informacje o poprzedniej awarii [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
Obsługa wyjątków mach [[BITHockeyManager sharedHockeyManager].disableMachExceptionHandler = YES] Dokumentacja (domyślnie włączona)
Dołączanie dodatkowych danych meta Tak Dokumentacja (można dołączyć z delegata)
Okno dialogowe Dostosowywanie użytkownika setCrashReportUIHandler Dokumentacja (domyślnie nie podano)
Wyłączanie usługi w czasie wykonywania [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled:NO]