Migrace ze sady HockeySDK na sadu App Center SDK pro iOS

  • Č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.embeddedframework 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.embeddedframework ze systému souborů.

Podfile

Pokud jste přidali sadu SDK pomocí CocoaPods, odeberte pod "HockeySDK" řá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
UpdateManager Distribute

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 AppCenterDistribute;

    import AppCenter
import AppCenterAnalytics
import AppCenterCrashes
import AppCenterDistribute

  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 sharedHockeyManager].authenticator authenticateInstallation];

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

    Po:

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

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

    Poznámka

    Sada App Center SDK nemá ekvivalenty pro [[BITHockeyManager sharedHockeyManager] configureWithBetaIdentifier:liveIdentifier:delegate].

  3. [Volitelné] Úprava souboru Info.plist projektu

    Pokud máte v úmyslu použít funkci Distribuovat, postupujte podle výše uvedených kroků:

    • Přidejte nový klíč pro URL types soubor Info.plist nebo CFBundleURLTypes do souboru Info.plist (pro případ, že XCode zobrazí váš Soubor Info.plist jako zdrojový kód).
    • Změňte klíč první podřízené položky na URL Schemes nebo CFBundleURLSchemes.
    • Zadejte appcenter-${APP_SECRET} jako schéma adresy URL a nahraďte ${APP_SECRET} tajným kódem aplikace vaší aplikace.

    Další informace najdete v dokumentaci k distribuci app center.

  4. 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]
Identifikace instalací [BITHockeyManager sharedHockeyManager].installString [MSACAppCenter installId]
Identifikace uživatelů [BITHockeyManager sharedHockeyManager].userID [MSACAppCenter setUserId:@"your-user-id"]

Analýzy

HockeySDK ve výchozím nastavení umožňuje shromažďování metrik. Sada App Center SDK registruje službu Analytics jenom v případě, že metodě předáte Analytics třídu start .

Funkce HockeyApp App Center
Automatické sledování relací Nejde zakázat Dokumentace (nejde zakázat)
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

Sada HockeySDK ve výchozím nastavení umožňuje hlášení chybových 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 zaregistruje službu Crashes pouze v případě, že metodě předáte Crashes třídu start .

Funkce HockeyApp App Center
Automatické odesílání chybových ukončení [[BITHockeyManager sharedHockeyManager].crashManager setCrashManagerStatus: BITCrashManagerStatusAutoSend] 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]
Zpracování výjimek Mach Ve výchozím nastavení zakázaná Dokumentace (ve výchozím nastavení povoleno)
Připojit další metadata Yes Dokumentace (lze připojit od delegáta)
Dialogové okno Přizpůsobit uživatele setAlertViewHandler Dokumentace (ve výchozím nastavení není k dispozici)
Zakázání služby za běhu [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled:NO]

Rozmístit

Poznámka

Na rozdíl od HockeyApp bude funkce aktualizací v aplikaci App Center fungovat JENOM s buildy distribuovanými pomocí služby App Center Distribute. Distribuce nebude fungovat, když je ladicí program připojený. Pokud aplikace používá privátní distribuční skupinu, po instalaci a prvním otevření aplikace po přidání sady App Center Distribute SDK se otevře prohlížeč pro ověření uživatele a povolení aktualizací v aplikaci. Tento prohlížeč se také otevře, pokud za běhu nastavíte privátní trasu aktualizací v aplikaci. Jedná se o jednorázový krok, ke kterému nedojde v dalších verzích vaší aplikace. Další podrobnosti najdete v dokumentaci k distribuci app center .

Sada HockeySDK ve výchozím nastavení nepovoluje aktualizace v aplikaci. Sada App Center SDK registruje službu aktualizací v aplikaci pouze v případě, že metodě předáte Distribute třídu start . Tento modul je ve výchozím nastavení povolený, na rozdíl od sady HockeySDK.

Funkce HockeyApp App Center
Omezené aktualizace v aplikaci [[BITHockeyManager sharedHockeyManager].authenticator authenticateInstallation] MSACDistribute.updateTrack
Zakázání služby za běhu [[BITHockeyManager sharedHockeyManager] setDisableUpdateManager: YES] [MSACDistribute setEnabled:NO]
Přizpůsobení dialogového okna aktualizace shouldDisplayUpdateAlertForUpdateManager Dokumentace