Eseguire la migrazione da HockeySDK a App Center SDK per Unity
Importante
Visual Studio App Center è previsto 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 che è possibile considerare la migrazione a.
Altre informazioni sulle sequenze temporali di supporto e sulle alternative.
Seguire questa documentazione se si vuole aggiornare l'applicazione per usare App Center SDK anziché HockeySDK.
1. Aggiornare le librerie
1.1 Rimuovere il vecchio hockeySDK
Scegliere l'oggetto gioco creato per l'SDK e rimuovere il componente facendo clic sull'icona >ImpostazioniRimuovi
HockeyAppAndroid/HockeyAppiOScomponente.Rimuovere la cartella HockeyAppUnityAndroid / HockeyAppUnityiOS dalla cartella Asset all'interno del progetto Unity.
1.2 Aggiungere un nuovo SDK di App Center
App Center SDK è integrato importando pacchetti Unity nel progetto. A tale scopo, installare prima di tutto il plug-in App Center Unity Editor Extensions. Aprire le estensioni Editor tramite il menu Unity: Window>App CenterEditor Estensioni e selezionare Installa App Center> SDK.
App Center SDK è progettato con un approccio modulare: è possibile integrare solo i servizi interessati. Vedere le equivalenze nella tabella successiva:
| Modulo HockeyApp | Modulo di App Center |
|---|---|
Crashes and Exceptions |
Crashes |
Metrics |
Analytics |
Version Updates |
Distribute |
Per installare i servizi separatamente, è possibile selezionare Installa SDK in ogni scheda.
Nota
App Center Unity SDK è uno per tutte e tre le piattaforme: Android, iOS e UWP. Non è necessario installare ogni SDK separatamente.
Il modo consigliato per integrare App Center Unity SDK consiste nell'usare App Center Editor Extension, ma sono supportati altri scenari. Per altre informazioni, vedere la documentazione di App Center Unity.
2. Configurare l'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 Configurare l'SDK
Collegare lo script del Centro app
Nella finestra Progetto passare alla cartella AppCenter aggiunta al progetto. Individuare lo script con il logo di App Center come icona, denominato AppCenterBehaviore trascinarlo nell'oggetto gioco usato in precedenza per HockeySDK.
Configurare le impostazioni di App Center
Fare clic su questo oggetto gioco e nella finestra Inspector verrà visualizzata la configurazione di App Center.
Compilare le informazioni aggiuntive usando la tabella di mapping di configurazione dettagliata, riportata di seguito.
3. Servizi e confronto delle funzionalità
| Impostazione hockeyapp | Impostazione del Centro app | Note |
|---|---|---|
| ID dell'app | Segreto dell'app Android/iOS | Usare l'ID app convertito nel passaggio precedente |
| URL server | URL log personalizzato, sezione Altro programma di installazione | Controllare Usare l'URL del log personalizzato |
| Aggiornamenti in-app con restrizioni | ND | Distribute.UpdateTrack |
| Arresti anomali e eccezioni (abilitati per impostazione predefinita) | Usare arresti anomali | Modulo arresti anomali |
| Arresti anomali del caricamento automatico | NA (abilitato per impostazione predefinita) | Documentazione (abilitata per impostazione predefinita, può essere configurata) |
| Registrazione eccezioni | Livello di log iniziale, sezione Altro programma di installazione | Se si vuole una registrazione più dettagliata, usare Verbose |
| Metriche utente | Usare Analisi | Modulo analisi |
| Versione Aggiornamenti (abilitata per impostazione predefinita) | Usare Distribute | Distribuire il modulo |
| Aggiornare un avviso | ND | Documentazione (deve essere configurata) |
Nota
Se il progetto non supporta una delle tre piattaforme elencate nelle impostazioni, lasciare il campo segreto dell'app come è; non avrà alcun effetto. Se il progetto supporta piattaforme che App Center non supporta, le API e la configurazione non avranno alcun effetto per tali piattaforme.
Se il progetto ha le chiamate API HockeySDK in tutta l'applicazione, sostituirle usando la tabella dettagliata del mapping API specificata di seguito.
| Funzionalità | HockeyApp | App Center |
|---|---|---|
| Eventi personalizzati con proprietà | HockeyAppIOS.TrackEvent o HockeyAppAndroid.TrackEvent | Analytics.TrackEvent |
| Controllare in modo esplicito gli aggiornamenti | HockeyAppIOS.CheckForUpdate o HockeyAppAndroid.CheckForUpdate | Distribute.CheckforUpdate |
| Visualizzare un modulo di feedback | HockeyAppIOS.ShowFeedbackForm o HockeyAppAndroid.ShowFeedbackForm | NA (vedere la sezione seguente) |
Servizio commenti e suggerimenti
Il servizio di feedback non sarà supportato in App Center. Vedere Feedback di HockeyApp.