Migrace ze sady HockeySDK na sadu App Center SDK pro tvOS

  • Článek

Důležité

31. března 2025 je naplánované vyřazení z provozu. I když můžete dál používat Visual Studio App Center, dokud ho úplně vyřadíte, existuje několik doporučených alternativ, na které můžete zvážit migraci.

Přečtěte si další informace o časových osách a alternativách podpory.

Pokud chcete aplikaci aktualizovat tak, aby místo sady HockeySDK používala sadu App Center SDK, postupujte podle této dokumentace.

1. Aktualizace knihoven

1.1 Odebrat starý HockeySDK

Ruční

Pokud jste sadu SDK přidali ručně, postupujte takto:

  1. Odeberte HockeySDK.framework odkaz z projektu XCode. Klikněte na tlačítko Odebrat odkaz , neklikejte na tlačítko Přesunout do koše .

  2. Otevřete nastavení projektu a na kartě Nastavení sestavení v částechCestyhledání v rozhraní Prohledat cesty / hlaviček odeberte umístění pro soubory hlaviček související s HockeySDK.

  3. Otevřete nastavení projektu a na kartě Fáze sestavení v části Propojit binární soubor s knihovnami odeberte položky závislostí související s HockeySDK.

  4. Odstranit HockeySDK.framework ze systému souborů.

Podfile

Pokud jste přidali sadu SDK pomocí CocoaPods, odeberte pod "HockeySDK-tvOS" řádek ze souboru Podfile a pak spusťte pod installpříkaz .

Kartágo

  1. Odeberte odkazy HockeySDK z .Cartfile Odstranit Cartfile.Resolved ze systému souborů.

  2. Odstraňte HockeySDK.framework a HockeySDK.framework.dSYM z projektu XCode a klikněte na tlačítko Přesunout do koše .

  3. Otevřete kartu Fáze sestavení a vyhledejte oddíl Spustit skript . Odeberte HockeyApp z input.xcfilelist a output.xcfilelist.

1.2 Přidání nové sady App Center SDK

Sada App Center SDK podporuje integraci prostřednictvím Cocoapods, Carthage, Swift Package Manageru a pomocí architektur v projektu Xcode. Podrobné pokyny k integraci sady App Center SDK najdete v dokumentaci k sadě App Center SDK.

Poznámka

Sada App Center SDK je navržená s modulárním přístupem, takže můžete používat libovolnou nebo všechny služby. Podívejte se na ekvivalence v další tabulce:

Třída HockeyApp Modul App Center
MetricsManager Analytics
CrashManager Crashes

2. Aktualizace instalačního kódu sady SDK

2.1 Převod identifikátoru aplikace

Sada App Center SDK používá identifikátory aplikace ve formátu globálně jedinečných identifikátorů (GUID). Id aplikace HockeyApp může App Center používat, ale musíte ho převést do jiného formátu. Pokud chcete převést identifikátor, musíte přidat čtyři pomlčky, abyste získali reprezentaci 8-4-4-4-12.

Před (HockeyApp): 00112233445566778899aabbccddeeff

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

2.2 Nahrazení inicializace sady SDK v kódu aplikace

  1. Nahraďte následující importy ve třídě AppDelegate .

    Před:

    @import HockeySDK;

    import HockeySDK

    Po:

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

    import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

  2. Nahradit registrační kód

    Vyhledejte metodu didFinishLaunchingWithOptions a nahraďte výskyty kódu HockeyApp.

    Před:

    [[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. Nahraďte volání rozhraní API HockeyApp v celé aplikaci. Podrobné tabulky mapování rozhraní API jsou uvedené níže.

3. Porovnání služeb a funkcí

Jádro

Funkce HockeyApp App Center
Úprava úrovně protokolu [BITHockeyManager sharedHockeyManager].logLevel = BITLogLevelVerbose [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

Analýzy

HockeySDK ve výchozím nastavení shromažďuje metriky. Sada App Center SDK ve výchozím nastavení neshromažďuje žádné metriky (analytické). Pokud chcete shromažďovat metriky pomocí sady App Center SDK, předejte MSACAnalytics ji metodě start: .

Funkce HockeyApp App Center
Automatické sledování relací Ve výchozím nastavení povolená Dokumentace (ve výchozím nastavení povoleno)
Vlastní události s vlastnostmi Yes [MSACAnalytics trackEvent:withVlastnosti:]
Zakázání služby za běhu [BITHockeyManager sharedHockeyManager].disableMetricsManager = YES [MSACAnalytics setEnabled:NO]

Pády

HockeySDK ve výchozím nastavení hlásí chybové ukončení. Chybové ukončení se okamžitě odešle na server při příštím spuštění aplikace. Sada App Center SDK ve výchozím nastavení nehlásí žádné chybové ukončení. Pokud chcete shromažďovat chybové ukončení pomocí sady App Center SDK, předejte MSACCrashes ji metodě start: .

Funkce HockeyApp App Center
Automatické odesílání chybových ukončení Ve výchozím nastavení povolená Dokumentace (ve výchozím nastavení povoleno)
Vygenerování chybového ukončení testu [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
Informace o předchozím chybovém ukončení [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
Připojení dalších metadat Yes Dokumentace (lze připojit od delegáta)
Dialogové okno Přizpůsobit uživatele setCrashReportUIHandler Dokumentace (ve výchozím nastavení není k dispozici)
Zakázání služby za běhu [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled:NO]