Instalar el agente de Android

Para instalar el agente de Android, le recomendamos seguir nuestra instalación guiada:

1. Vaya a one.newrelic.com > Integrations & Agents > Mobile > Android.
2. Siga los pasos de instalación guiados para configurar su agente de Android.
3. Espere unos minutos y luego vea sus datos yendo a one.newrelic.com > All capabilities > Mobile > (select your app).

Instalar manualmente el agente de Android

Los pasos a continuación se describen en nuestra instalación guiada. Tenga en cuenta que incluso si instala manualmente el agente, aún necesitará crear una aplicación New Relic y obtener el token de aplicación generado. Este token es esencial para que el agente envíe datos a 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"
    ... >

Elija dónde iniciar el agente

Recomendamos iniciar el agente desde Application.onCreate(). Android crea la clase Application antes que cualquier Activity, por lo que el agente se ejecuta independientemente de si la aplicación se abre en su Activity de lanzamiento habitual o en uno diferente, por ejemplo, desde una notificación push, un enlace profundo, un acceso directo de la aplicación o un widget.

Aún puede iniciar el agente en el método onCreate() de un Activity. Si lo hace, el agente se ejecuta solo para el lanzamiento que alcance ese Activity. Si mueve la llamada start() a la clase Application, elimínela de Activity.

Tenga en cuenta lo siguiente:

• Inicie el agente una vez. El agente ignora cualquier llamada a start() mientras ya se está ejecutando, por lo que dejar la llamada en ambos lugares no inicia el agente dos veces.
• Android ejecuta Application.onCreate() en cada proceso que declara la aplicación. Si alguno de los componentes establece android:process, el agente también se inicia en cada uno de esos procesos y cada uno reporta su propia sesión. Inicie el agente solo cuando el código se esté ejecutando en el proceso principal de la aplicación.
• start() lee y escribe archivos pequeños en el hilo de llamada, por lo que StrictMode puede informar el acceso al disco en el hilo principal dondequiera que lo llame.

¿Que sigue?

¡Felicidades! Ha instalado correctamente el agente de Android. Tiene algunas opciones para los siguientes pasos:

• Configure el comportamiento del agente durante las compilaciones de Gradle con el complemento New Relic Gradle.
• Actualice el SDK del agente de Android para mantener actualizado su agente de Android.
• ¿Tienes problemas con la instalación de tu Android? Siga los procedimientos de resolución de problemas.

Android 4.x: soporte multidex

El monitoreo de móviles para versiones de Android anteriores a Android 5.0 (API nivel 21) utiliza el tiempo de ejecución de Dalvik para ejecutar el código de la aplicación. De forma predeterminada, Dalvik limita las aplicaciones a un único archivo de código de bytes classes.dex por APK. Para evitar esta limitación, debe habilitar la compatibilidad con multidex. Luego puede usar la biblioteca de soporte multidex, que pasa a formar parte del archivo DEX principal de su aplicación. La biblioteca gestiona el acceso a los archivos DEX adicionales y el código que los contiene.