Migrer du Kit de développement logiciel (SDK) HockeySDK vers Le Kit de développement logiciel (SDK) App Center pour Cordova

Article
03/15/2024

Important

La mise hors service de Visual Studio App Center est prévue pour le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à sa mise hors service complète, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager la migration.

En savoir plus sur les chronologies et les alternatives de support.

Suivez cette documentation si vous souhaitez mettre à jour votre application pour utiliser le Kit de développement logiciel (SDK) App Center au lieu de HockeySDK.

1. Mettre à jour les bibliothèques

1.1 Supprimer l’ancien HockeySDK

Ouvrez une fenêtre de terminal, accédez au dossier du projet Cordova et exécutez la commande suivante :
```
cordova plugin add cordova-plugin-appcenter-analytics
```
Accédez au dossier Vos plateformes > d’application > android > platform_www > plug-ins et supprimez-y cordova-plugin-hockeyapp.

1.2 Ajouter un nouveau Kit de développement logiciel (SDK) App Center

Le Kit de développement logiciel (SDK) App Center est conçu avec une approche modulaire : vous pouvez intégrer uniquement les services qui vous intéressent. Consultez les équivalences dans le tableau suivant :

Module HockeyApp	Module App Center	Commande install
`Crashes and Exceptions`	`Crashes`	`cordova plugin add cordova-plugin-appcenter-crashes`
`Metrics`	`Analytics`	`cordova plugin add cordova-plugin-appcenter-analytics`

Exécutez l’une des commandes pour installer le module dont vous avez besoin (ou les deux).

2. Mettre à jour le code d’installation du SDK

2.1 Convertir l’identificateur d’application

Le Kit de développement logiciel (SDK) App Center utilise des identificateurs d’application au format GUID (Identificateur global unique). Votre ID d’application HockeyApp peut être utilisé par App Center, mais vous devez le convertir dans un autre format. Pour convertir l’identificateur, vous devez ajouter quatre traits d’union pour obtenir une représentation 8-4-4-4-12.

Avant (HockeyApp) : 00112233445566778899aabbccddeeff

Après (App Center) : 00112233-4455-6677-8899-aabbccddeeff

2.2 Remplacer l’initialisation du Kit de développement logiciel (SDK) dans le code de l’application

Supprimez l’initialisation HockeyApp à l’intérieur du deviceready gestionnaire :
```
hockeyapp.start(null, null, "APP_ID");
```
Configurer le Kit de développement logiciel (SDK) App Center

Ouvrez le fichier config.xml du projet Apache Cordova ; pour chacun des éléments cibles platform de votre projet Apache Cordova (uniquement Android et iOS aujourd’hui), ajoutez un élément enfant preference au format suivant :
```
<preference name="APP_SECRET" value="{App Secret from the previous step}" />
```
Pour plus d’informations, consultez la documentation App Center Cordova.
Remplacez tous les appels d’API HockeyApp dans l’application. Les tables de mappage d’API détaillées sont fournies ci-dessous.

3. Comparaison des services et des fonctionnalités

Core

Fonctionnalité	HockeyApp	App Center
Identifier les utilisateurs	hockeyapp.setUserName ou hockeyapp.setUserEmail	AppCenter.setUserId

Analytics

Fonctionnalité	HockeyApp	App Center
Suivre automatiquement les sessions	Documentation (ne peut pas être désactivée)	Documentation (activée par défaut)
Suivre les événements	hockeyapp.trackEvent	Analytics.trackEvent

Crashes

Fonctionnalité	HockeyApp	App Center
Envoyer automatiquement des incidents	paramètre autoSend (désactivé par défaut)	APPCENTER_CRASHES_ALWAYS_SEND (activé par défaut)
Attacher des métadonnées supplémentaires	hockeyapp.addMetaData	Documentation (peut être jointe à partir de l’écouteur)
Générer un incident de test	hockeyapp.forceCrash	AppCenter.Crashes.generateTestCrash
Afficher une boîte de dialogue en cas d’incident	ignoreDefaultHandler (désactivé par défaut, Android uniquement)	AppCenter.Crashes.process (rappel lors du traitement d’un incident)

Mises à jour de version

Le service App Center Distribute n’est pas encore pris en charge dans le Kit de développement logiciel (SDK) App Center Cordova.

Service de commentaires

Le service de commentaires ne sera pas pris en charge dans App Center. Consultez commentaires HockeyApp.

Partager via