Partager via


Migrer de HockeySDK vers App Center WPF/Winforms

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

  1. 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");
    
  2. 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.