Migrer de HockeySDK vers App Center WPF/Winforms

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

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

Visual Studio pour Windows

Ouvrez Visual Studio pour Windows.
Cliquez sur Fichier>Ouvrir 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.WPF .
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 Console> dugestionnaire de packageNuGet Package Manager>.
Si vous travaillez dans Visual Studio pour Mac, vérifiez que les extensions de gestion de package NuGet sont installées. Pour cela, choisissezExtensionsVisual Studio>, recherchez NuGet et installez, si nécessaire.
Tapez les commandes suivantes dans la console :

Uninstall-Package HockeySDK.WPF
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 choisir les services que vous souhaitez intégrer. Vous devez ajouter chaque module sdk en tant que dépendance distincte dans cette section.

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 8-4-4-4-12 une 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 using déclaration d’instruction, 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 de journalisation	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
Envoyer automatiquement des incidents	Activée par défaut	Rapports d’incidents
Attacher des métadonnées supplémentaires	Yes	Ajout de pièces jointes
Suivre les exceptions gérées	`HockeyClient.Current.TrackException`	Erreurs gérées

Distribution

Le SDK App Center ne prend pas encore en charge la distribution pour les applications WPF/Winforms.

Service de commentaires

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

Partager via