Bien démarrer avec MAUI et Xamarin

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 par configurer le SDK .NET App Center dans votre application pour utiliser App Center Analytics et App Center Crashes. Pour ajouter App Center Distribute à votre application, consultez la documentation relative à App Center Distribute.

1. Prérequis

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

• Votre projet est configuré dans Visual Studio ou Visual Studio pour Mac.
• Vous ciblez des appareils exécutant iOS 11.0 ou version ultérieure ou Android 5.0 (niveau d’API 21) ou version ultérieure.
• Vous n’utilisez pas d’autres SDK qui fournissent des fonctionnalités de création de rapports d’incident.

Plateformes prises en charge :

• MAUI iOS
• MAUI Android
• MAUI Windows
• .NET 6.0 macOS
• Xamarin.Android
• Xamarin.iOS
• Xamarin.Mac
• Xamarin.Forms (applications iOS, macOS Android, UWP et Windows Desktop)

1.1 MAUI

1.2 À propos de Xamarin.Android

Créez une application sur le portail App Center avec Android comme système d’exploitation et Xamarin comme plateforme.

1.3 À propos de Xamarin.iOS

Créez une application sur le portail App Center avec iOS comme système d’exploitation et Xamarin comme plateforme.

1.4 À propos de Xamarin.Mac

Créez une application sur le portail App Center avec macOS comme système d’exploitation et Xamarin comme plateforme.

1.5 À propos de Xamarin.Forms (iOS, macOS, Android, UWP et Windows Desktop)

Créez 5 applications dans App Center : une pour chaque système d’exploitation.

Vous devez sélectionner Xamarin comme plateforme pour les applications Android, iOS et macOS (les applications UWP et Desktop n’ont pas d’option Xamarin).

Pour les applications Windows Desktop et macOS , vous devez configurer votre projet pour la compatibilité avec la plateforme Xamarin.Forms .

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. Passez à appcenter.ms.
2. 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.
3. Entrez un nom et une description facultative pour votre application.
4. Sélectionnez le système d’exploitation et la plateforme appropriés en fonction de votre projet, comme décrit ci-dessus.
5. 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 sur 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 le Kit de développement logiciel (SDK) App Center à votre solution

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 pour Mac

• Ouvrez Visual Studio.
• Cliquez sur Ouvrir un fichier> et choisissez votre solution.
• Dans le navigateur de solutions, cliquez avec le bouton droit sur la section Packages , puis choisissez Ajouter des packages NuGet....
• Recherchez App Center, puis sélectionnez App Center Analytics et App Center Crashes.
• Cliquez sur Ajouter des packages.

Visual Studio pour Windows

• 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.
• Recherchez App 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.
• Si vous travaillez dans Visual Studio pour Mac, vérifiez que vous avez installé les extensions de gestion des packages NuGet. Pour cela, choisissezExtensions>, recherchez NuGet et installez, si nécessaire.
• Tapez la commande suivante dans la console :

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

4.1 Ajouter les déclarations using

Ajoutez les espaces de noms appropriés dans les fichiers suivants :

• MAUI et Xamarin.Forms - App.xaml.cs
• Xamarin.iOS et Xamarin.Mac - AppDelegate.cs
• Xamarin.Android - MainActivity.cs

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

4.2 Ajouter la Start() méthode

4.2.1 MAUI et Xamarin.Forms

Vous devez créer différentes applications pour chaque plateforme sur le portail App Center. Pour chaque application, vous aurez un secret d’application différent. Ouvrez le fichier App.xaml.cs du projet et ajoutez la ligne suivante dans le constructeur (ou dans la OnStart() méthode pour Xamarin.Forms).

AppCenter.Start("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={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("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics));
    AppCenter.Start(typeof(Crashes));
}

4.2.2 Xamarin.Android

Ouvrez le fichier MainActivity.cs du projet et ajoutez l’appel Start() à l’intérieur de la OnCreate() méthode

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

4.2.3 Xamarin.iOS et Xamarin.Mac

Ouvrez le fichier du AppDelegate.cs projet et ajoutez l’appel Start() à l’intérieur de la FinishedLaunching() méthode

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

4.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 et App Center Crashs.

Si vous ne souhaitez pas utiliser l’un des deux services, supprimez le paramètre correspondant de l’appel de méthode ci-dessus.

Sauf si vous spécifiez explicitement chaque module 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 modules inclus dans le premier appel seront disponibles.

Par exemple : si vous souhaitez intégrer App Center Analytics, vous devez modifier l’appel Start() comme suit :

4.3.1 MAUI et Xamarin.Forms

AppCenter.Start("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}", typeof(Analytics));

4.3.2 Xamarin Native

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

Excellent, vous êtes tous configurés pour visualiser les données d’analyse et de blocage 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.

Pour savoir comment bien démarrer avec les mises à jour dans l’application, lisez la documentation de App Center Distribute.

5. Règles de sauvegarde (Android uniquement)

Si vous utilisez la sauvegarde automatique pour éviter d’obtenir des informations incorrectes sur les appareils, suivez les étapes suivantes :

5.1. Pour Android 11 (niveau d’API 30) ou inférieur.

1. Créez appcenter_backup_rule.xml fichier dans le dossier Resources/xml .

2. Ouvrez le fichier AndroidManifest.xml du projet. Ajoutez l’attribut android:fullBackupContent à l’élément <application> . Il doit pointer vers le fichier de ressources appcenter_backup_rule.xml .

android:fullBackupContent="@xml/appcenter_backup_rule"

3. Ajoutez les règles de sauvegarde suivantes au fichier appcenter_backup_rule.xml :

<full-backup-content xmlns:tools="http://schemas.android.com/tools">
      <exclude domain="sharedpref" path="AppCenter.xml"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
      <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
      <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
  </full-backup-content>

5.2. Pour Android 12 (niveau d’API 31) ou version ultérieure.

1. Créez appcenter_backup_rule.xml fichier dans le dossier Resources/xml .

2. Ouvrez le fichier AndroidManifest.xml du projet. Ajoutez l’attribut android:dataExtractionRules à l’élément <application> . Il doit pointer vers le fichier de ressources appcenter_backup_rule.xml .

android:dataExtractionRules="@xml/appcenter_backup_rule"

3. Ajoutez les règles de sauvegarde suivantes au fichier appcenter_backup_rule.xml :

<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </device-transfer>
</data-extraction-rules>