Prise en main de WPF/WinForms

  • Article

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.

Le Kit de développement logiciel (SDK) App Center utilise une architecture modulaire pour vous permettre d’utiliser tout ou partie des services.

Commençons à configurer le Kit de développement logiciel (SDK) App Center dans votre application pour utiliser App Center Analytics et les incidents App Center.

1. Prérequis

Avant de commencer, vérifiez que les conditions préalables suivantes sont remplies :

  • Votre projet cible .NET Framework 4.6.2 (ou version ultérieure) ou .NET Core 3.1 (ou version ultérieure).
  • .NET Core est pris en charge uniquement lorsque l’application WPF/WinForms s’exécute sur Windows.
  • Si vous utilisez le Kit de développement logiciel (SDK) à partir d’une bibliothèque portable, il doit cibler .NET Standard 2.0 ou version ultérieure (PCL n’est pas pris en charge).
  • Type de projet PackageReference. Cette exigence provient de la SQLitePCL.raw bibliothèque. Pour plus d’informations, consultez https://github.com/ericsink/SQLitePCL.raw/issues/537.
  • Il existe un problème connu lors de l’intégration du Kit de développement logiciel (SDK) dans des projets VSTO. Pour plus d’informations, visitez https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

2. Créez votre application dans le portail App Center pour obtenir le secret de l’application

Si vous avez déjà créé votre application dans le portail App Center, vous pouvez ignorer cette étape.

  1. Inscrivez-vous ou connectez-vous, puis appuyez sur le bouton bleu dans le coin supérieur droit du portail qui indique Ajouter nouveau , puis sélectionnez Ajouter une nouvelle application dans le menu déroulant.
  2. Entrez un nom et une description facultative pour votre application.
  3. Sélectionnez le système d’exploitation et la plateforme appropriés en fonction de votre projet, comme décrit ci-dessus.
  4. Appuyez sur le bouton en bas à droite qui indique Ajouter une nouvelle application.

Une fois que vous avez créé une application, vous pouvez obtenir son secret d’application dans la page Paramètres du portail App Center. Dans le coin supérieur droit de la page Paramètres , cliquez sur les points verticaux triples et sélectionnez Copy app secret pour obtenir votre secret d’application.

3. Ajouter les modules du Kit de développement logiciel (SDK) App Center

Le Kit de développement logiciel (SDK) App Center peut être intégré à l’aide de Visual Studio ou de la console du Gestionnaire de package.

Notes

Le SDK App Center utilise des assemblys à nom fort pour la compatibilité avec les applications qui utilisent un signe à nom fort.

Visual Studio

  • Ouvrez Visual Studio.
  • 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.
  • Sous l’onglet Parcourir, 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>.
  • Tapez les commandes suivantes :
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Notes

Si vous utilisez le Kit de développement logiciel (SDK) App Center dans un projet portable, vous devez installer les packages dans chacun des projets : le portable et le projet qui exécute l’application WPF/WinForms. Pour ce faire, vous devez ouvrir chaque sous-projet et suivre les étapes correspondantes décrites dans la section Visual Studio .

4. Démarrer le KIT de développement logiciel (SDK)

Pour utiliser App Center, optez pour le ou les modules que vous souhaitez utiliser. Par défaut, aucun module n’est démarré et vous devez appeler explicitement chacun d’eux lors du démarrage du Kit de développement logiciel (SDK).

4.1 Ajouter la Start() méthode

WPF

Pour votre application WPF, modifiez et App.xaml.cs ajoutez les instructions using suivantes :

using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;

Ensuite, dans le même fichier, ajoutez le code suivant dans la OnStartup méthode :

AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));

Si le App.xaml.cs fichier n’a pas la OnStartup méthode , vous pouvez ajouter la Application.OnStartup(StartupEventArgs) méthode . Votre App.xaml.cs fichier doit ressembler à ceci :

public partial class App : Application
{
    protected override void OnStartup(StartupEventArgs e)
    {
      base.OnStartup(e);
      AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));
    }
  }
}

Avertissement

Il n’est pas recommandé d’incorporer votre secret d’application dans le code source.

Si vous devez démarrer les services App Center séparément, vous devez :

  1. Configurez ou démarrez-le avec le secret de l’application.
  2. Si le code peut être appelé plusieurs fois, case activée si l’App Center est déjà configuré.
  3. Démarrez le ou les services requis sans le secret d’application.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

WinForms

Pour votre application WinForms, modifiez le Program.cs fichier et ajoutez les instructions using suivantes :

using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;

Ensuite, dans le même fichier, ajoutez le code suivant dans la Main méthode, avant l’instruction Application.Run .

AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));

Si vous devez démarrer les services App Center séparément, vous devez :

  1. Configurez ou démarrez-le avec le secret de l’application.
  2. Si le code peut être appelé plusieurs fois, case activée si l’App Center est déjà configuré.
  3. Démarrez le ou les services requis sans le secret d’application.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

Avertissement

Il n’est pas recommandé d’incorporer votre secret d’application dans le code source.

4.2 Remplacer l’espace réservé par votre secret d’application

Veillez à remplacer {Your App Secret} le texte par la valeur réelle de votre application. Le secret de l’application se trouve dans la page Prise en main ou dans la page Paramètres du portail App Center.

La page Prise en main contient l’exemple de code ci-dessus avec votre secret d’application. Vous pouvez copier-coller l’exemple entier.

L’exemple ci-dessus montre comment utiliser la Start() méthode et inclut App Center Analytics.

Sauf si vous spécifiez explicitement chaque service en tant que paramètres dans la méthode start, vous ne pouvez pas utiliser ce service App Center. En outre, l’API Start() ne peut être utilisée qu’une seule fois dans le cycle de vie de votre application : tous les autres appels enregistrent un avertissement dans la console et seuls les services inclus dans le premier appel seront disponibles.

Super, vous êtes prêt à visualiser les incidents sur le portail que le SDK collecte automatiquement.

Consultez la documentation relative aux incidents App Center Analytics et App Center pour découvrir comment personnaliser et utiliser des fonctionnalités plus avancées des deux services.