Condividi tramite

Eseguire la migrazione da HockeySDK ad App Center SDK per tvOS

  • Articolo

Importante

Visual Studio App Center è pianificato per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate a cui è possibile prendere in considerazione la migrazione.

Altre informazioni sulle sequenze temporali di supporto e sulle alternative.

Seguire questa documentazione se si vuole aggiornare l'applicazione per usare App Center SDK invece di HockeySDK.

1. Aggiornare le librerie

1.1 Rimuovere HockeySDK precedente

Manuale

Se l'SDK è stato aggiunto manualmente, seguire questa procedura:

  1. Rimuovere HockeySDK.framework il riferimento dal progetto XCode. Fare clic sul pulsante Rimuovi riferimento , non fare clic sul pulsante Sposta nel Cestino .

  2. Aprire le impostazioni del progetto e nella scheda Impostazioni di compilazione nelle sezioni Percorsi / diricerca del frameworkdi ricerca intestazionerimuovere i percorsi per i file di intestazione correlati a HockeySDK.

  3. Aprire le impostazioni del progetto e nella scheda Fasi di compilazione nella sezione Collegare file binari con librerie rimuovere le voci di dipendenza correlate a HockeySDK.

  4. Eliminare HockeySDK.framework dal file system.

Podfile

Se l'SDK è stato aggiunto usando CocoaPods, rimuovere la pod "HockeySDK-tvOS" riga dal Podfile, quindi eseguire pod install.

Carthage

  1. Rimuovere i riferimenti HockeySDK da Cartfile. Eliminare Cartfile.Resolved dal file system.

  2. Eliminare HockeySDK.framework e HockeySDK.framework.dSYM dal progetto XCode e fare clic sul pulsante Sposta nel Cestino .

  3. Aprire la scheda Fasi di compilazione e individuare la sezione Esegui script . Rimuovere HockeyApp da input.xcfilelist e output.xcfilelist.

1.2 Aggiungere il nuovo SDK di App Center

App Center SDK supporta l'integrazione tramite Cocoapods, Carthage, Swift Package Manager e usando i framework nel progetto Xcode. Leggere istruzioni dettagliate su come integrare App Center SDK nella documentazione di App Center SDK.

Nota

App Center SDK è progettato con un approccio modulare in modo da poter usare qualsiasi o tutti i servizi. Vedere le equivalenze nella tabella successiva:

Classe HockeyApp Modulo di App Center
MetricsManager Analytics
CrashManager Crashes

2. Aggiornare il codice di installazione dell'SDK

2.1 Convertire l'identificatore dell'applicazione

App Center SDK usa gli identificatori dell'applicazione nel formato GUID (Global Unique Identifier). L'ID app HockeyApp può essere usato da App Center, ma è necessario convertirlo in un formato diverso. Per convertire l'identificatore è necessario aggiungere quattro trattini per ottenere una rappresentazione 8-4-4-4-12.

Prima (HockeyApp): 00112233445566778899aabbccddeeff

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

2.2 Sostituire l'inizializzazione dell'SDK nel codice dell'applicazione

  1. Sostituire le importazioni seguenti nella classe AppDelegate .

    Prima di:

    @import HockeySDK;

    import HockeySDK

    Dopo:

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

    import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

  2. Sostituire il codice di registrazione

    Trovare il didFinishLaunchingWithOptions metodo e sostituire le occorrenze del codice HockeyApp.

    Prima di:

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

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

    Dopo:

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

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

  3. Sostituire le chiamate API HockeyApp in tutta l'applicazione. Di seguito sono riportate le tabelle dettagliate per il mapping delle API.

3. Confronto tra servizi e funzionalità

Core

Funzionalità HockeyApp App Center
Regolare il livello di log [BITHockeyManager sharedHockeyManager].logLevel = BITLogLevelVerbose [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

Analisi

HockeySDK raccoglie le metriche per impostazione predefinita. App Center SDK non raccoglie metriche (analisi) per impostazione predefinita. Per raccogliere le metriche usando App Center SDK, passare MSACAnalytics al start: metodo .

Funzionalità HockeyApp App Center
Tenere traccia automatica delle sessioni Abilitata per impostazione predefinita Documentazione (abilitata per impostazione predefinita)
Eventi personalizzati con proprietà Sì [MSACAnalytics trackEvent:withProperties:]
Disabilitare il servizio in fase di esecuzione [BITHockeyManager sharedHockeyManager].disableMetricsManager = YES [MSACAnalytics setEnabled:NO]

Crashes

Il hockeySDK segnala l'arresto anomalo per impostazione predefinita. Gli arresti anomali verranno inviati immediatamente al server alla successiva avvio dell'app. App Center SDK non segnala alcun arresto anomalo per impostazione predefinita. Per raccogliere arresti anomali usando App Center SDK, passare MSACCrashes al start: metodo .

Funzionalità HockeyApp App Center
Invia automaticamente arresti anomali Abilitata per impostazione predefinita Documentazione (abilitata per impostazione predefinita)
Generare un arresto anomalo del test [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
Informazioni sull'arresto anomalo precedente [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
Collegare metadati aggiuntivi Sì Documentazione (può essere collegata dal delegato)
Personalizzare la finestra di dialogo utente setCrashReportUIHandler Documentazione (non fornita per impostazione predefinita)
Disabilitare il servizio in fase di esecuzione [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled:NO]