Monitorez votre application mobile Unity

Examiner les exigences

Avant d’installer l’agent Unity, assurez-vous que votre application Unity répond à ces exigences de version :

• Pour les applications natives Android :

  • API Android 24 ou supérieur
  • Voir les exigences natives d'Android

• Pour les applications natives iOS :

  • Voir les exigences natives iOS

Ajoutez l'agent Unity à votre projet

Dans le gestionnaire de paquets Unity, ajoutez l'URL GitHub suivante :

https://github.com/newrelic/newrelic-unity-agent.git

Ajouter un ou plusieurs jetons d'application

Pour permettre à New Relic d’authentifier les données de votre application Unity, procédez comme suit :

1. Obtenez votre jeton d'application auprès de New Relic :

   1. Allez à one.newrelic.com, cliquez sur Integrations & Agents, puis cliquez sur Mobile.
   2. Sélectionnez votre application Unity.
   3. Allez dans Settings > Application et copiez le Application token affiché.

2. Ajoutez le jeton à votre projet Unity :

   1. Ouvrez votre IDE Unity.

   2. Accédez à Tools > New Relic > Getting Started pour ouvrir la fenêtre de l’éditeur.

   3. Collez le jeton d'application approprié dans le champ correspondant pour chaque plateforme prise en charge par votre application :

      • Android: Collez le jeton Android dans le champ « jeton Android App ».
      • iOS : Collez le jeton iOS dans le champ « Jeton d'application iOS ».

      Si votre application fonctionne à la fois sur Android et iOS, fournissez un jeton distinct pour chaque plateforme. N'utilisez pas le même jeton pour les deux.

   

(Android uniquement) Configurez votre application Android

Pour configurer votre application Android, vous devez personnaliser vos modèles Gradle. Si vous utilisez Unity 2019 ou une version ultérieure, suivez les étapes ci-dessous.

1. Dans vos paramètres de build Gradle, vous devrez inclure l'URL du référentiel New Relic Maven. Pour ce faire, ouvrez votre fichier mainTemplate.gradle , qui se trouve généralement dans le dossier Assets/Plugins/Android . Ajoutez le snippet suivant :

   allprojects {
     buildscript {
       repositories {
         ARTIFACTORY_REPOSITORY
         google()
         jcenter()
         mavenCentral()
       }
     }
   }

   Copier

2. Dans votre fichier baseProjectTemplate.gradle (généralement situé dans le dossier Android de votre projet Unit), ajoutez New Relic classpath au niveau du projet :

   dependencies {
     // If you are changing the Android Gradle Plugin version,
     // make sure it is compatible with the Gradle version preinstalled with Unity.
     // See which Gradle version is preinstalled with Unity here:
     //    https://docs.unity3d.com/Manual/android-gradle-overview.html
     // See the official Gradle and Android Gradle Plugin compatibility table here:
     //    https://developer.android.com/studio/releases/gradle-plugin#updating-gradle
     // To specify a custom Gradle version in Unity, go to "Preferences > External Tools",
     // uncheck "Gradle Installed with Unity (recommended)",
     // and specify a path to a custom Gradle version.
     classpath 'com.newrelic.agent.android:agent-gradle-plugin:7.2.0'
     BUILD_SCRIPT_DEPS
   }

   Copier

   Si vous utilisez une ancienne version d'Unity qui nécessite Gradle 7.0 ou une version antérieure, vous devrez utiliser une dépendance de chemin de classe spécifique pour garantir la compatibilité :

   dependencies {
     // If you are changing the Android Gradle Plugin version,
     // make sure it is compatible with the Gradle version preinstalled with Unity.
     // See which Gradle version is preinstalled with Unity here:
     //    https://docs.unity3d.com/Manual/android-gradle-overview.html
     // See official Gradle and Android Gradle Plugin compatibility table here:
     //    https://developer.android.com/studio/releases/gradle-plugin#updating-gradle
     // To specify a custom Gradle version in Unity, go to "Preferences > External Tools",
     // uncheck "Gradle Installed with Unity (recommended)",
     // and specify a path to a custom Gradle version.
     classpath 'com.newrelic.agent.android:agent-gradle-plugin:6.11.0'
     BUILD_SCRIPT_DEPS
   }

   Copier

   Si votre projet utilise un plug-in DSL, apportez les modifications suivantes (et ignorez l'étape 3) :

   Dans android/app/build.gradle :

   plugins {
       id "com.android.application"
       id "kotlin-android"
       id "com.newrelic.agent.android" version "7.5.1"  //<-- include this
   }

   Copier

3. Dans votre fichier launcherTemplate.gradle (généralement situé dans le dossier Android de votre projet Unity), appliquez le plug-in newrelic en haut de votre fichier launcherTemplate.gradle :

   apply plugin: "com.android.application"
   apply plugin: 'newrelic' // <-- add this

   Copier

4. Dans votre fichier AndroidManifest.xml , ajoutez les autorisations suivantes :

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

   Copier

(iOS uniquement) Gérer les dépendances

Pour iOS, vérifiez les paramètres de votre gestionnaire de dépendances externes :

1. Dans votre IDE Unity, accédez à Assets et ouvrez le External Dependency Manager.

2. Cliquez sur iOS Resolver.

3. Dans la section de configuration de Podfile, vérifiez ces paramètres :

   • Add use_frameworks! to Podfile est désactivé
   • Always add the main target to Podfile est activé
   

4. Si vous n'utilisez pas Podfile pour la gestion des dépendances iOS, suivez ces étapes :

   1. Téléchargez et décompressez le SDK New Relic XCFramework (agent iOS). Vous pouvez obtenir le dernier agent iOS à partir de nos notes de sortie de l'agent iOS.

   2. Ajoutez le New Relic XCFramework à votre projet Xcode :

      1. Décompressez le téléchargement du SDK.
      2. Depuis votre Finder, faites glisser le dossier NewRelicAgent.xcframework dans votre projet Xcode, en le plaçant dans votre volet de framework cible.
      3. Sous la colonne Embed , cliquez sur Embed & Sign.

   Et c'est fait ! Vous devriez commencer à voir les données dans New Relic dans les 5 minutes.