Bien démarrer avec UWP/WinUI

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 :

Pour le projet UWP :

• Votre projet est configuré dans Visual Studio 2017 Update 15.9 ou version ultérieure.
• Vous ciblez des appareils exécutant Windows 10 build 16299 ou version ultérieure.
• Votre projet fait référence à la plateforme Windows universelle 6.2.8 ou ultérieure (ce package est généralement référencé implicitement).
• NuGet 4.3 ou version ultérieure.

Pour le projet WinUI :

• Votre projet est configuré dans Visual Studio 2019 Update 16.9 ou version ultérieure.
• Vous ciblez des appareils exécutant Windows 10 build 17763 ou version ultérieure.
• Votre projet fait référence à WinUI 3 0.8.0 ou version ultérieure.

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.

1. 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.
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, 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.

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

Maintenant que vous avez intégré le Kit de développement logiciel (SDK) dans votre application, il est temps de démarrer le Kit de développement logiciel (SDK) et d’utiliser les services App Center.

4. Ajouter la Internet (Client) fonctionnalité

Dans l’Explorateur de solutions Visual Studio, double-cliquez sur le fichier Package.appxmanifest pour votre application. Cliquez sur l’onglet Fonctionnalités , puis vérifiez la fonctionnalité Internet (client ).

5. Démarrez le Kit de développement logiciel (SDK)

Pour utiliser App Center, vous devez choisir 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).

5.1 Ajouter les directives using

Ajoutez les espaces de noms appropriés avant d’utiliser nos API.

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

5.2 Ajouter la Start() méthode

Ajoutez l’appel suivant au constructeur de votre application :

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, vérifiez si l’App Center est déjà configuré.
3. 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)); 
}

5.3 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.

Excellent, vous êtes tous configurés pour visualiser Analytics sur le portail que le Kit de développement logiciel (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.