Prise en main de WPF/WinForms

2025-05-05

Important

Visual Studio App Center a été mis hors service le 31 mars 2025, à l’exception des fonctionnalités d’analyse et de diagnostic, qui continueront d’être prises en charge jusqu’au 30 juin 2026. En savoir plus.

Le Kit de développement logiciel (SDK) App Center utilise une architecture modulaire pour vous permettre d’utiliser n’importe quel ou tous les services.

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

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 (LA PCL n’est pas prise en charge).
Type de projet PackageReference. Cette exigence provient de la SQLitePCL.raw bibliothèque. Plus d’informations à l’adresse 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, veuillez consulter https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

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

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

Inscrivez-vous ou connectez-vous et appuyez sur le bouton bleu situé en haut à droite du portail, qui indique Ajouter une nouvelle application et sélectionnez Ajouter une nouvelle application dans le menu déroulant.
Entrez un nom et une description facultative pour votre application.
Sélectionnez le système d’exploitation et la plateforme appropriés en fonction de votre projet, comme décrit ci-dessus.
Appuyez sur le bouton en bas à droite, indiquant 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. En haut à droite 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.

Remarque

Le Kit de développement logiciel (SDK) App Center utilise des assemblies signées par un nom fort pour la compatibilité avec les applications qui utilisent une signature forte avec nom.

Visual Studio

Ouvrez Visual Studio.
Cliquez sur Ouvrir un fichier> et choisissez votre solution.
Dans le navigateur de solutions, cliquez avec le bouton droit sur Références et choisissez Gérer les packages NuGet.
Sous l’onglet Parcourir, recherchezApp Center et installez les packages Microsoft.AppCenter.Analytics et Microsoft.AppCenter.Crash .

Console du Gestionnaire de package

Ouvrez la console dans Visual Studio. Pour ce faire, choisissez Tools>Gestionnaire de packages NuGet>Console du gestionnaire de packages.
Tapez les commandes suivantes :

Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Remarque

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émarrez 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 (Windows Presentation Foundation)

Pour votre application WPF, modifiez App.xaml.cs 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 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 :

Configurez ou démarrez-le avec le secret de l’application.
Si le code peut être appelé plusieurs fois, vérifiez si l’App Center est déjà configuré.
Démarrez le ou les services requis sans 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 :

Configurez ou démarrez-le avec le secret de l’application.
Si le code peut être appelé plusieurs fois, vérifiez si l’App Center est déjà configuré.
Démarrez le ou les services requis sans 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. La clé secrète de l’application se trouve dans la page Prise en main ou 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 dans celui-ci, vous pouvez copier-coller l’exemple entier.

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

Sauf si vous spécifiez explicitement chaque service comme paramètres dans la méthode de démarrage, 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 consignent un avertissement à la console et seuls les services inclus dans le premier appel seront disponibles.

Très bien, vous êtes tous configurés pour visualiser les blocages sur le portail que le SDK collecte automatiquement.

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

Partager via