Installer l'agent Android

Pour installer l'agent Android, nous vous recommandons de suivre notre installation guidée :

1. Allez à one.newrelic.com > Integrations & Agents > Mobile > Android.
2. Suivez les étapes d'installation guidée pour configurer votre agent Android.
3. Attendez quelques minutes, puis visualisez vos données en allant sur one.newrelic.com > All capabilities > Mobile > (select your app).

Installer manuellement l'agent Android

Les étapes ci-dessous sont décrites dans notre installation guidée. Notez que même si vous installez manuellement l'agent, vous devrez toujours créer une application New Relic et obtenir le jeton d'application généré. Ce jeton est essentiel pour que l'agent puisse envoyer des données à New Relic.

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

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

buildscript {
  repositories {
    mavenCentral()
  }

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

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

plugins {
  id("newrelic")
}

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

import android.app.Application;
import com.newrelic.agent.android.NewRelic;

public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    NewRelic.withApplicationToken("GENERATED_TOKEN").start(this);
  }
}

<application
    android:name=".MyApplication"
    ... >

Choisissez où démarrer l’agent

Nous vous recommandons de démarrer l'agent à partir de Application.onCreate(). Android crée votre classe Application avant tout Activity, de sorte que l'agent s'exécute que votre application s'ouvre sur son Activity de lancement habituel, ou sur un autre, par exemple à partir d'une notification push, d'un lien profond, d'un raccourci d'application, ou d'un widget.

Vous pouvez toujours démarrer l'agent dans la méthode onCreate() d'un Activity. Si vous le faites, l'agent ne s'exécute que pour chaque lancement qui atteint ce Activity. Si vous déplacez l'appel start() vers votre classe Application, supprimez-le de votre Activity.

Gardez à l’esprit les points suivants :

• Démarrez l’agent une fois. L’agent ignore tout appel à start() lorsqu’il est déjà en cours d’exécution, laisser l’appel aux deux endroits ne démarre donc pas l’agent deux fois.
• Android exécute Application.onCreate() dans chaque processus que votre application déclare. Si l’un de vos composants définit android:process, l’agent démarre également dans chacun de ces processus, et chacun d’eux signale sa propre session. Démarrez l’agent uniquement lorsque votre code s’exécute dans le processus principal de votre application.
• start() lit et écrit de petits fichiers sur le thread appelant, de sorte que StrictMode peut signaler l'accès au disque sur le thread principal où que vous l'appeliez.

Quelle est la prochaine étape ?

Félicitations ! Vous avez installé avec succès l'agent Android. Vous avez plusieurs options pour les prochaines étapes :

• Configurez le comportement de l'agent pendant les builds Gradle avec le plugin New Relic Gradle.
• Mettez à niveau le SDK Android de l'agent pour maintenir votre agent Android à jour.
• Vous rencontrez des problèmes avec votre installation Android ? Suivez les procédures de dépannage.

Android 4.x : prise en charge de Multidex

monitoring des applications mobiles pour les versions Android antérieures à Android 5.0 (niveau d'API 21) utilise le runtime Dalvik pour exécuter le code de l'application. Par défaut, Dalvik limite les applications à un seul fichier bytecode classes.dex par APK. Pour contourner cette limitation, vous devez activer la prise en charge multidex. Vous pouvez ensuite utiliser la bibliothèque de support multidex, qui fait partie du fichier DEX principal de votre application. La bibliothèque gère l'accès aux fichiers DEX supplémentaires et au code qu'ils contiennent.