Installer l'agent Android

Ajoutez le plugin d’agent Android à votre projet.

Concernant l'emplacement du plugin, vous avez deux options :

• Recommandé : Utilisation du plugin Gradle DSL

  • À partir de la version 7.6.0 de l'agent, le plugin d'agent Android est disponible sur le portail des plugins Gradle en tant que plugin communautaire. Le plugin Gradle DSL simplifie l'ajout de dépendances de plugins aux applications.
  • Cette méthode consiste à ajouter la dépendance du plug-in de l'agent au bloc DSL des plug-ins de votre projet.

• ID du plug-in hérité (newrelic)

  • Pour les projets plus anciens ou les cas d'utilisation spécifiques, vous pouvez utiliser l'ID de plug-in legacy .
  • Cette méthode consiste à ajouter l'agent en tant que dépendance au script de build de votre projet, en spécifiant le référentiel MavenCentral.

  Suivez les étapes détaillées ci-dessous pour la méthode d’installation choisie.

  (Recommandé) Appliquez le plugin à l'aide du bloc DSL des plugins

  L'approche recommandée pour gérer la dépendance des plugins dans Gradle utilise le bloc DSL des plugins. Cette section détaille l'application de la forme entièrement qualifiée de l'ID du plugin (com.newrelic.agent.android) dans cette structure.

  1. Déclarez le plug-in New Relic dans le fichier build.gradle(.kts) de niveau supérieur à l'aide de l'ID du plug-in Gradle Plugin Portal :

     plugins {
       // for binary Gradle plugins that need to be resolved
       id("com.newrelic.agent.android") version "AGENT_VERSION" apply false
     }

     Copier

     Assurez-vous de remplacer AGENT_VERSION par le numéro de version de votre agent. Nous vous recommandons fortement d'utiliser la dernière version.

  2. Appliquez le plugin explicitement au fichier de build au niveau de l'application (et à tous les sous-modules destinés à l'instrumentation) en utilisant la syntaxe suivante :

     plugins {
       id("com.newrelic.agent.android")
     }

     Copier

     Pour des informations détaillées sur l'application des plugins dans Gradle, reportez-vous à la documentation Gradle.

  Appliquer le plugin en utilisant le bloc buildscript{}

  Le plugin d'agent Android est disponible sur MavenCentral et utilise l'ID de plugin legacy newrelic pour la compatibilité avec les projets plus anciens. Si vous choisissez d’exploiter cet ID legacy pour une application existante, vous devrez configurer explicitement le chemin de classe vers MavenCentral. Cela garantit que Gradle peut localiser le plugin pendant votre processus de construction. Pour plus de détails sur les différentes méthodes de résolution des plugins, reportez-vous à la documentation Gradle.

  Pour préférer MavenCentral au portail des plugins Gradle, vous devez apporter les modifications suivantes aux fichiers Gradle :

  1. Ajoutez ce snippet à votre build.gradle(.kts) de niveau supérieur déposer:

     buildscript {
       repositories {
         mavenCentral()
       }
     
       // not required if plugin classpath in resolutionStrategy{} below
       dependencies {
         classpath "com.newrelic.agent.android:agent-gradle-plugin:AGENT_VERSION"
       }
     }

     Copier

  2. Ajoutez ce snippet à votre fichier settings.gradle(.kts) via le bloc pluginManagement {} :

     pluginManagement {
       repositories {
         mavenCentral()  // adds repo for NewRelic artifacts
       }
       resolutionStrategy {
         eachPlugin {
           // not required if using `classpath dependency` above
           if (requested.id.id.startsWith("newrelic") || requested.id.id.startsWith("com.newrelic.agent.android")) {
             useModule("com.newrelic.agent.android:agent-gradle-plugin:${AGENT_VERSION}")
           }
         }
       }
       plugins {
          id("newrelic") apply false
       }
     }

     Copier

     Assurez-vous de remplacer AGENT_VERSION par le numéro de version de votre agent. Nous vous recommandons fortement d'utiliser la dernière version.

  3. Appliquez le plugin au fichier de build au niveau de l'application, ainsi qu'à tout autre sous-module à instrumenter :

     plugins {
       id("newrelic")
     }

     Copier

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" />

Dans votre classe principale Activity au sein de la méthode onCreate , ajoutez cette instruction d'importation :

import com.newrelic.agent.android.NewRelic;

Remarque : vous devez ajouter cette instruction d’importation à la classe Activity . Nous ne prenons pas en charge le démarrage de l'agent dans d'autres classes.

Dans la méthode onCreate , ajoutez la ligne suivante, en veillant à remplacer GENERATED_TOKEN par votre jeton d'application réel (créé lors de l'installation guidée) :

NewRelic.withApplicationToken("GENERATED_TOKEN").start(this.getApplicationContext());

(Facultatif) Configuration supplémentaire pour Proguard/Dexguard

Si vous utilisez ProGuard ou Dexguard pour réduire le code, suivez ces étapes :

1. Créez un fichier newrelic.properties dans votre répertoire au niveau de l’application (ex : /projectname/app/newrelic.properties).

2. Dans ce nouveau fichier, ajoutez la ligne suivante, en remplaçant GENERATED_TOKEN par votre jeton réel :

   com.newrelic.application_token=GENERATED_TOKEN

   Copier

3. Suivez les étapes décrites dans Configurer ProGuard ou DexGuard pour les applications Android.

Nettoyez votre projet, puis exécutez votre application dans un émulateur ou un appareil pour générer du trafic. Attendez quelques minutes pendant que votre agent capture ces données.

Affichez les données de votre application sur New Relic en accédant à one.newrelic.com > All capabilities > Mobile > (select an app).