Udostępnij za pośrednictwem

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

  • Artykuł

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Chociaż możesz nadal używać programu Visual Studio App Center do momentu jego 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 Usuń stare HockeySDK

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 struktury / wyszukiwania nagłówkówusuń lokalizacje plików nagłówków związanych z hockeySDK.

  3. Otwórz ustawienia projektu i na karcie Fazy kompilacji w sekcji Połącz plik binarny z bibliotekami usuń wpisy zależności związane z zestawem HockeySDK.

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

Podfile

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

Kartagina

  1. Usuń odwołania HockeySDK z pliku Cartfile. Usuń Cartfile.Resolved z systemu plików.

  2. Usuń HockeySDK.framework i HockeySDK.framework.dSYM z projektu XCode, a następnie kliknij przycisk Przenieś do kosza .

  3. Otwórz kartę Fazy kompilacji i znajdź sekcję Uruchamianie skryptu . Usuń usługę HockeyApp z elementu input.xcfilelist i output.xcfilelist.

1.2. Dodawanie nowego zestawu SDK centrum aplikacji

Zestaw SDK usługi App Center obsługuje integrację za pośrednictwem platform Cocoapods, Carthage, Swift Package Manager i przy użyciu struktur w projekcie Xcode. Przeczytaj szczegółowe instrukcje dotyczące 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ł usługi App Center
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 usługę App Center, 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 (App Center): 00112233-4455-6677-8899-aabbccddeeff

2.2 Zastępowanie inicjowania 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. Zamień 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. Szczegółowe tabele mapowania interfejsu API podano poniżej.

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 domyślnie zbiera metryki. Zestaw SDK centrum aplikacji domyślnie nie zbiera żadnych metryk (analizy). Aby zbierać metryki przy użyciu zestawu SDK centrum aplikacji, przekaż MSACAnalytics go 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

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

Cecha HockeyApp App Center
Automatyczne wysyłanie awarii Domyślnie włączone Dokumentacja (domyślnie włączona)
Generowanie awarii testowej [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
Informacje o poprzedniej awarii [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
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]