Eseguire la migrazione da HockeySDK ad App Center SDK per Cordova

Articolo
03/15/2024

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

Aprire una finestra del terminale, passare alla cartella del progetto Cordova ed eseguire il comando seguente:
```
cordova plugin add cordova-plugin-appcenter-analytics
```
Passare alla cartella Your app > platforms > android > platform_www > plugins ed eliminare cordova-plugin-hockeyapp da esso.

1.2 Aggiungere un nuovo SDK di App Center

App Center SDK è progettato con un approccio modulare. È possibile integrare solo i servizi a cui si è interessati. Vedere le equivalenze nella tabella successiva:

Modulo HockeyApp	Modulo di App Center	Comando Installa
`Crashes and Exceptions`	`Crashes`	`cordova plugin add cordova-plugin-appcenter-crashes`
`Metrics`	`Analytics`	`cordova plugin add cordova-plugin-appcenter-analytics`

Eseguire uno dei comandi per installare il modulo necessario (o entrambi).

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

Rimuovere l'inizializzazione hockeyapp all'interno del deviceready gestore:
```
hockeyapp.start(null, null, "APP_ID");
```
Configurare App Center SDK

Aprire il file diconfig.xml del progetto Apache Cordova; per ogni elemento di destinazione platform del progetto Apache Cordova (solo Android e iOS oggi), aggiungere un elemento figlio preference nel formato seguente:
```
<preference name="APP_SECRET" value="{App Secret from the previous step}" />
```
Per altre informazioni, vedere la documentazione di App Center Cordova.
Sostituire tutte 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
Identificare gli utenti	hockeyapp.setUserName o hockeyapp.setUserEmail	AppCenter.setUserId

Analisi

Funzionalità	HockeyApp	App Center
Tenere traccia automatica delle sessioni	Documentazione (non può essere disabilitata)	Documentazione (abilitata per impostazione predefinita)
Registrare eventi	hockeyapp.trackEvent	Analytics.trackEvent

Crashes

Funzionalità	HockeyApp	App Center
Invia automaticamente arresti anomali	parametro autoSend (disabilitato per impostazione predefinita)	APPCENTER_CRASHES_ALWAYS_SEND (abilitata per impostazione predefinita)
Allegare metadati aggiuntivi	hockeyapp.addMetaData	Documentazione (può essere collegata dal listener)
Generare un arresto anomalo del test	hockeyapp.forceCrash	AppCenter.Crashes.generateTestCrash
Visualizzare una finestra di dialogo in caso di arresto anomalo	ignoreDefaultHandler (disabilitato per impostazione predefinita, solo Android)	AppCenter.Crashes.process (callback durante l'elaborazione di un arresto anomalo)

Aggiornamenti delle versioni

Il servizio App Center Distribute non è ancora supportato in App Center Cordova SDK.

Servizio commenti e suggerimenti

Il servizio di feedback non sarà supportato in App Center. Vedere Il feedback di HockeyApp.

Condividi tramite