Udostępnij za pośrednictwem

Migrowanie z zestawu HockeySDK do zestawu SDK centrum aplikacji dla systemu iOS

  • 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.embeddedframework 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.embeddedframework z systemu plików.

Podfile

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

Kartagina

  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 .

  3. Otwórz kartę Fazy kompilacji i znajdź sekcję Uruchom skrypt . Usuń aplikację HockeyApp z elementu input.xcfilelist i output.xcfilelist.

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 przy użyciu struktur 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
UpdateManager Distribute

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

    import AppCenter
import AppCenterAnalytics
import AppCenterCrashes
import AppCenterDistribute

  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 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])

    Uwaga

    Zestaw SDK usługi App Center nie ma odpowiedników dla [[BITHockeyManager sharedHockeyManager] configureWithBetaIdentifier:liveIdentifier:delegate]elementu .

  3. [Opcjonalnie] Modyfikowanie pliku Info.plist projektu

    Jeśli zamierzasz użyć narzędzia Distribute, wykonaj powyższe kroki:

    • Dodaj nowy klucz dla URL types pliku Info.plist lub CFBundleURLTypes w pliku Info.plist (w przypadku, gdy program XCode wyświetli plik Info.plist jako kod źródłowy).
    • Zmień klucz pierwszego elementu podrzędnego na URL Schemes lub CFBundleURLSchemes.
    • Wprowadź appcenter-${APP_SECRET} jako schemat adresu URL i zastąp ciąg ${APP_SECRET} kluczem tajnym aplikacji.

    Aby uzyskać więcej informacji na ten temat, zapoznaj się z dokumentacją dotyczącą dystrybucji usługi App Center.

  4. 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]
Identyfikowanie instalacji [BITHockeyManager sharedHockeyManager].installString [MSACAppCenter installId]
Identyfikowanie użytkowników [BITHockeyManager sharedHockeyManager].userID [MSACAppCenter setUserId:@"your-user-id"]

Analiza

Zestaw HockeySDK umożliwia zbieranie metryk na wartość domyślną. Zestaw SDK centrum aplikacji rejestruje usługę Analizy tylko wtedy, gdy przekazujesz Analytics klasę start do metody.

Cecha HockeyApp App Center
Automatyczne śledzenie sesji Nie można wyłączyć Dokumentacja (nie można jej wyłączyć)
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

Zestaw HockeySDK umożliwia raportowanie awarii na wartość domyślną. Awarie zostaną natychmiast wysłane na serwer przy następnym uruchomieniu aplikacji. Zestaw SDK centrum aplikacji rejestruje usługę Awarie tylko w przypadku przekazania Crashes klasy do start metody.

Cecha HockeyApp App Center
Automatyczne wysyłanie awarii [[BITHockeyManager sharedHockeyManager].crashManager setCrashManagerStatus: BITCrashManagerStatusAutoSend] 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 Domyślnie wyłączone Dokumentacja (domyślnie włączona)
Dołączanie dodatkowych danych meta Tak Dokumentacja (można dołączyć z delegata)
Okno dialogowe Dostosowywanie użytkownika setAlertViewHandler Dokumentacja (domyślnie nie podano)
Wyłączanie usługi w czasie wykonywania [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled:NO]

Rozłóż

Uwaga

W przeciwieństwie do usługi HockeyApp funkcja aktualizacji w centrum aplikacji będzie działać tylko z kompilacjami, które są dystrybuowane przy użyciu usługi dystrybucji Centrum aplikacji. Dystrybucja nie będzie działać po dołączeniu debugera. Jeśli aplikacja korzysta z prywatnej grupy dystrybucyjnej, po zainstalowaniu i otwarciu aplikacji po raz pierwszy po dodaniu zestawu SDK rozproszonego centrum aplikacji zostanie otwarta przeglądarka w celu uwierzytelnienia użytkownika i włączenia aktualizacji w aplikacji. Ta przeglądarka zostanie również otwarta, jeśli ustawisz prywatną ścieżkę aktualizacji w aplikacji w czasie wykonywania. Jest to jednorazowy krok, który nie będzie występować w kolejnych wersjach aplikacji. Aby uzyskać więcej informacji, zapoznaj się z dokumentacją dystrybucji centrum aplikacji .

Zestaw HockeySDK domyślnie nie włącza aktualizacji w aplikacji. Zestaw SDK centrum aplikacji rejestruje usługę aktualizacji w aplikacji tylko wtedy, gdy przekazujesz Distribute klasę start do metody. Ten moduł jest domyślnie włączony w przeciwieństwie do zestawu HockeySDK.

Cecha HockeyApp App Center
Aktualizacje z ograniczeniami w aplikacji [[BITHockeyManager sharedHockeyManager].authenticator authenticateInstallation] MSACDistribute.updateTrack
Wyłączanie usługi w czasie wykonywania [[BITHockeyManager sharedHockeyManager] setDisableUpdateManager: YES] [MSACDistribute setEnabled:NO]
Dostosowywanie okna dialogowego aktualizacji shouldDisplayUpdateAlertForUpdateManager Dokumentacja