Prise en main d’UWP/WinUI

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.

• Android
• iOS
• Extensions iOS
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• Extensions macOS
• tvOS
• Cordova

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 :

Pour le projet UWP :

• Votre projet est configuré dans Visual Studio 2017 Update 15.9 ou version ultérieure.
• Vous ciblez les appareils exécutant Windows 10 build 16299 ou version ultérieure.
• Votre projet fait référence plateforme Windows universelle 6.2.8 ou version 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 une version ultérieure.
• Votre projet fait référence à WinUI 3 0.8.0 ou version ultérieure.

Notes

Si vous souhaitez utiliser Xamarin.Forms pour UWP, suivez la documentation prise en main de Xamarin au lieu de celle-ci.

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.

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

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

Notes

Si vous utilisez le Kit de développement logiciel (SDK) App Center dans un projet portable (tel que Xamarin.Forms), vous devez installer les packages dans chacun des projets : portable, Android et iOS. Pour ce faire, vous devez ouvrir chaque sous-projet et suivre les étapes correspondantes décrites dans la section Visual Studio .

4. Ajouter la Internet (Client) fonctionnalité

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

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

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

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)); 
}

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

Parfait, vous êtes prêt à visualiser Analytics 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.