Migrer de HockeySDK vers App Center UWP

Article
03/17/2024

Important

Visual Studio App Center doit être mis hors service le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à ce qu’il soit entièrement mis hors service, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager de migrer.

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

Notes

Les plateformes telles que WinRT, Windows Phone 8.0 et 8.1, WPF et PCL ne sont pas prises en charge dans le SDK App Center. Vous pouvez continuer à utiliser hockeySDK avec eux.

Remplacez le package NuGet HockeySDK.UWP par les packages App Center de tous les projets de votre solution.

Visual Studio pour Windows

Ouvrez Visual Studio pour Windows.
Cliquez sur Ouvrir le fichier> et choisissez votre solution.
Dans le navigateur de solution, cliquez avec le bouton droit sur Références et choisissez Gérer les packages NuGet.
Supprimez le package HockeySDK.UWP .
Recherchez App Center et installez les packages Microsoft.AppCenter.Analytics et Microsoft.AppCenter.Crashes .

Console du Gestionnaire de package

Ouvrez la console dans Visual Studio. Pour ce faire, choisissez Outils>NuGet Package ManagerPackage Manager> Console.
Si vous travaillez dans Visual Studio pour Mac, vérifiez que vous avez installé les extensions de gestion de package NuGet. Pour cela, choisissezExtensionsVisual Studio>, recherchez NuGet et installez, si nécessaire.
Tapez la commande suivante dans la console :

Uninstall-Package HockeySDK.UWP
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Le Kit de développement logiciel (SDK) App Center utilise une approche modulaire : vous pouvez intégrer uniquement les services qui vous intéressent. Vous devez ajouter chaque module SDK en tant que dépendance distincte dans cette section.

2. Mettre à jour le code d’installation du KIT de développement logiciel (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 (Global Unique Identifier). 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 8-4-4-4-12 représentation.

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’ancien code d’inscription HockeyApp.

Dans la déclaration d’instruction using , supprimez la ligne suivante :
```
using Microsoft.HockeyApp;
```
Au début du constructeur de classe App, supprimez la ligne suivante :
```
HockeyClient.Current.Configure("Your_App_ID");
```
Démarrez le Kit de développement logiciel (SDK) App Center.

Ajoutez les espaces de noms appropriés avant d’utiliser nos API.
```
using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;
```
Ajoutez l’appel suivant au constructeur de votre application :
```
AppCenter.Start("{Your App Secret}",  typeof(Analytics), typeof(Crashes));
```

3. Comparaison des services et des fonctionnalités

Core

Fonctionnalité	HockeyApp	App Center
Ajuster le niveau du journal	Yes	AppCenter.LogLevel

Analytics

Fonctionnalité	HockeyApp	App Center
Suivre automatiquement les sessions	Yes	Informations sur la session et l’appareil
Événements personnalisés avec des propriétés	`HockeyClient.TrackEvent`	Analytics.TrackEvent

Crashes

Fonctionnalité	HockeyApp	App Center
L’envoi automatique se bloque	Activée par défaut	Rapports d’incidents
Joindre des métadonnées supplémentaires	Oui	Non pris en charge
Suivre les exceptions gérées	`HockeyClient.Current.TrackException`	Non prise en charge

Distribution

Le Kit de développement logiciel (SDK) App Center ne prend pas encore en charge la distribution pour les applications UWP.

Service de commentaires

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

Share via