Partager via

Bien démarrer avec Unity

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 et configorons le Kit de développement logiciel (SDK) App Center Unity pour utiliser App Center Analytics et plantages. Pour ajouter App Center Distribute à votre application, consultez la documentation relative à App Center Distribute.

1. Prérequis

Avant de commencer, vérifiez que votre projet est configuré dans Unity 2018.1 ou version ultérieure.

Le Kit de développement logiciel (SDK) App Center pour Unity prend en charge les plateformes suivantes :

  • iOS (9.0 ou version ultérieure)
  • Android (5.0/API 21 ou version ultérieure)
  • UWP (build 16299 ou version ultérieure)

Remarque

La version du runtime de script .NET 3.5 et le serveur principal de script .NET ne sont plus pris en charge sur la plateforme UWP.

Pour savoir comment utiliser des coroutines/rappels plutôt qu’avec async/await.NET 3.5 le back-end, reportez-vous aux API asynchrones dans la section sdk Unity de la documentation.

En outre, le Kit de développement logiciel (SDK) App Center pour Unity est disponible uniquement en C#.

2. Créer votre application dans le portail App Center pour acquérir 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 à App Center.
  3. Cliquez sur le bouton bleu situé en haut à droite du portail, qui indique Ajouter nouveau et sélectionnez Ajouter une nouvelle application dans le menu déroulant.
  4. Entrez un nom et une description facultative pour votre application.
  5. Sélectionnez le système d’exploitation et la plateforme appropriés en fonction de votre projet, comme décrit ci-dessus.
  6. Cliquez sur le bouton Ajouter une nouvelle application en bas à droite de la page.

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 projet

3a Installer l’éditeur d’extension

Le Kit de développement logiciel (SDK) App Center est intégré en important des packages Unity dans votre projet. Pour ce faire, installez d’abord le plug-in Extensions de l’éditeur Unity App Center . Ouvrez les extensions de l’éditeur via le menu Unity : Extensions de l’éditeur Windows > App Center > , puis sélectionnez « Installer le Kit de développement logiciel (SDK) App Center ».

Remarque

Dans les versions Unity 2019.1.2f1 et ultérieures, il peut y avoir des erreurs dans les journaux pendant l’installation, par Coroutine continue failureexemple . Il s’agit d’un problème Unity connu et vous devez l’ignorer.

3.1b Installer des packages individuels

En guise d’alternative, chacun des packages Unity individuels peut être téléchargé et importé. Ils se trouvent sur la page GitHub du SDK App Center Unity. Téléchargez la dernière version du ou des packages que vous souhaitez utiliser. Son nom doit être au format AppCenter{Analytics/Crash/Distribute}-v{version}.unitypackage.

3.2b Importer le package

Ouvrez votre projet Unity, puis double-cliquez sur le package que vous avez téléchargé. Une fenêtre contextuelle doit apparaître dans votre projet Unity contenant une liste de fichiers. Sélectionnez Importer, et le Kit de développement logiciel (SDK) sera ajouté à votre projet. Répétez cette étape pour chaque package que vous avez téléchargé et envisagez d’utiliser dans votre projet.

4. Activer le Kit de développement logiciel (SDK)

4.1 Créer un objet game vide

App Center fonctionne en tant que composant auquel vous attachez un objet de jeu dans la scène dans laquelle votre jeu démarre. Accédez à cette scène et ajoutez un objet de jeu vide. Donnez-lui un nom descriptif, tel que « App Center ».

4.2 Attacher le script App Center

Dans la fenêtre Projet , accédez au dossier « AppCenter » qui a été ajouté à votre projet. Recherchez le script, nommé AppCenterBehavior, puis faites-le glisser sur votre objet de jeu nouvellement créé dans la fenêtre Hierarchy .

Remarque

Vous n’avez pas besoin d’ajouter App Center à chaque scène dans laquelle vous souhaitez l’utiliser. L’ajout à la première scène chargée suffit.

4.3 Configurer les paramètres app Center

Cliquez sur ce nouvel objet « App Center » et ajoutez vos secrets d’application aux champs correspondants dans la fenêtre Inspecteur . Veillez également à cocher les cases « Utiliser {service} » pour chaque service App Center que vous envisagez d’utiliser

Configuration du script App Center

Avertissement

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

Remarque

Si votre projet ne prend pas en charge l’une des trois plateformes répertoriées dans les paramètres, laissez le champ secret de l’application as-is; elle n’aura aucun effet. Si votre projet prend en charge les plateformes que App Center ne prend pas en charge, les API et la configuration n’ont aucun effet pour ces plateformes.

Excellent, vous êtes tous configurés pour visualiser les données d’analyse et de diagnostic (incident et erreur) dans le portail que le Kit de développement logiciel (SDK) collecte automatiquement.

Consultez la documentation pour App Center Analytics et App Center Crashes afin de découvrir comment utiliser des fonctionnalités plus avancées avec ces deux services.

Pour savoir comment prendre en main les mises à jour dans l’application, lisez la documentation relative à App Center Distribute.

5. Règles de sauvegarde (Android uniquement)

Remarque

Les applications qui ciblent Android 6.0 (niveau d’API 23) ou versions ultérieures ont la fonctionnalité "Auto Backup" automatiquement activée.

Remarque

Si vous disposez déjà d’un fichier personnalisé avec une règle de sauvegarde, passez à la troisième étape.

Remarque

Si vous n’avez pas encore votre propre fichier AndroidManifest.xml , créez-le dans le dossier Assets/Plugins/Android . Ce manifeste sera fusionné avec celui par défaut créé par Unity au moment de la compilation.

Si vous utilisez la sauvegarde automatique pour éviter d’obtenir des informations incorrectes sur l’appareil, procédez comme suit :

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

  1. Créez appcenter_backup_rule.xml fichier dans le dossier Assets/Plugins/Android/res/xml .
  1. 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"
  1. 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 Assets/Plugins/Android/res/xml .
  1. 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"
  1. 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>