Migrer du Kit de développement logiciel (SDK) HockeySDK vers App Center Android

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

Ouvrez le fichier build.gradle au niveau de l’application du projet (app/build.gradle) et remplacez la ligne suivante dans la dependencies { ... } configuration.

Avant :

implementation 'net.hockeyapp.android:HockeySDK:...'

Après :

def appCenterSdkVersion = '5.0.4'
implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
implementation "com.microsoft.appcenter:appcenter-distribute:${appCenterSdkVersion}"

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. Chaque module sdk doit être ajouté en tant que dépendance distincte dans cette section. Consultez les équivalences dans le tableau suivant :

Classe HockeyApp	Module App Center
`MetricsManager`	`Analytics`
`CrashManager`	`Crashes`
`UpdateManager`	`Distribute`

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

Remplacez les importations suivantes dans votre classe d’activité.

Avant :

import net.hockeyapp.android.CrashManager;
import net.hockeyapp.android.metrics.MetricsManager;
import net.hockeyapp.android.UpdateManager;

Après :

import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.analytics.Analytics;
import com.microsoft.appcenter.crashes.Crashes;
import com.microsoft.appcenter.distribute.Distribute;

Remplacez le code d’inscription à l’intérieur de la classe d’activité main de votre application ' onCreate-callback.

Avant :
```
CrashManager.register(this);
MetricsManager.register(getApplication());
UpdateManager.register(this);
```
Après :
```
AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class, Distribute.class);
```
Si vous avez utilisé des métadonnées pour fournir l’identificateur de l’application, vous devez le copier dans le code d’initialisation et supprimer
```
<meta-data android:name="net.hockeyapp.android.appIdentifier" android:value="..." />
```
à partir de votre fichier AndroidManifest.xml .
Remplacez les appels d’API HockeyApp dans l’ensemble de 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
Ajuster le niveau de journalisation	`HockeyLog.setLogLevel`	AppCenter.setLogLevel
Identifier les installations	Interne uniquement	AppCenter.getInstallId
Identifier les utilisateurs	Incidents uniquement	AppCenter.setUserId

Analytics

Fonctionnalité	HockeyApp	App Center
Suivre automatiquement les sessions	Oui, peut être désactivé par `MetricsManager.setSessionTrackingDisabled`	Documentation (ne peut pas être désactivée)
Événements personnalisés avec des propriétés	`MetricsManager.trackEvent`	Analytics.trackEvent
Désactiver le service au moment de l’exécution	`MetricsManager.disableUserMetrics` et `MetricsManager.enableUserMetrics`	Analytics.setEnabled

Crashes

Fonctionnalité	HockeyApp	App Center
Envoyer automatiquement des incidents	Désactivée par défaut	Documentation (activée par défaut)
Attacher des métadonnées supplémentaires	Yes	Documentation (peut être jointe à partir de l’écouteur)
Boîte de dialogue Personnaliser l’utilisateur	Yes	Documentation (non fournie par défaut)
Obtenir des informations sur les status d’envoi	Yes	Documentation
Informations sur un incident précédent	`CrashManager.getLastCrashDetails`	Crashes.getLastSessionCrashReport

Distribuer

Notes

Contrairement à HockeyApp, la fonctionnalité des mises à jour dans l’application App Center fonctionne uniquement avec les builds RELEASE (par défaut) qui sont distribuées à l’aide du service App Center Distribute . Si l’application utilise un groupe de distribution privé, une fois l’application installée et ouverte pour la première fois après l’ajout du Kit de développement logiciel (SDK) App Center Distribute, un navigateur s’ouvre pour authentifier l’utilisateur et activer les mises à jour dans l’application. Ce navigateur s’ouvre également si vous définissez la piste de mise à jour privée dans l’application au moment de l’exécution. Il s’agit d’une étape unique qui ne se produira pas pour les versions ultérieures de votre application. Pour plus d’informations, consultez la documentation de distribution d’App Center .

Fonctionnalité	HockeyApp	App Center
Mises à jour restreintes dans l’application	`LoginManager.verifyLogin`	Distribute.setUpdateTrack
Désactiver le service au moment de l’exécution	`UpdateManager.unregister`	Distribute.setEnabled
Personnaliser la boîte de dialogue de mise à jour	Yes	Documentation

Service de commentaires

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

Partager via