Instalar el agente de Android

Para instalar el agente de Android, debe utilizar nuestra instalación guiada. La configuración del agente de Android requiere un token de aplicación que autentique cada aplicación móvil que desee monitor. El token de la aplicación solo está disponible mediante la instalación guiada.

Instale el agente de Android con instalación guiada

1. Vaya a

   one.newrelic.com > Add data > 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

Estos procedimientos aparecen en nuestra instalación guiada. Tenga en cuenta que incluso si está actualizando sus archivos de compilación a través de los documentos, aún debe agregar su aplicación a New Relic y obtener el token de aplicación generado desde la instalación guiada. De lo contrario, no podrá capturar datos sobre sus aplicaciones de Android.

1. Agregue el siguiente código a sus archivos build.gradle que se encuentran en la pestaña Gradle & Android Studio. Debe actualizar el fragmento de compilación de nivel superior y cada submódulo que desee instrumentar.

   Nivel de proyecto `build.gradle` archivo:

   En este ejemplo, <AGENT_VERSION> representa el número de versión de su agente. Consulte las notas de la versión del agente y utilice la versión más reciente.

   buildscript {
     repositories {
       mavenCentral()
     }
   
     dependencies {
       classpath "com.newrelic.agent.android:agent-gradle-plugin:<AGENT_VERSION>"
     }
   }

   Copia

   Nivel de aplicación `build.gradle` archivo:

   En este ejemplo, <AGENT_VERSION> representa el número de versión de su agente. Consulte las notas de la versión del agente y utilice la versión más reciente.

   repositories {
     mavenCentral()
   }
   
   apply plugin: 'android'
   apply plugin: 'newrelic'
   
   dependencies {
     implementation 'com.newrelic.agent.android:android-agent:<AGENT_VERSION>'
   }

   Copia

2. Establecer permisos de aplicaciones. Asegúrese de que su aplicación de Android solicite permisos INTERNET y ACCESS_NETWORK_STATE agregando estas líneas a su archivo AndroidManifest.xml :

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

   Copia

3. Inicie el agente de Android. En su Actividad predeterminada que se encuentra en su manifiesto, importe la clase NewRelic :

   import com.newrelic.agent.android.NewRelic;

   Copia

   No admitimos el inicio del agente monitoreo de aplicaciones móvilesen otras clases, ya que eso puede provocar un comportamiento inesperado o inestable.

4. Después de importar la clase NewRelic , debe agregar un fragmento adicional al método onCreate() , que incluye el token de su aplicación, que se genera en la instalación guiada. El fragmento se ve así:

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

   Copia

5. Si está utilizando la minificación (por ejemplo, con ProGuard o Dexguard), debe agregar el archivo newrelic.properties al directorio de nivel de su aplicación (nombre del proyecto/aplicación). Este paso solo se aplica al usuario de ProGuard y DexGuard.

   com.newrelic.application_token=<GENERATED_TOKEN>

   Copia

   Para finalizar la configuración de la minificación, siga los pasos en configurar ProGuard o DexGuard para aplicaciones de Android.

6. Limpie su proyecto, luego ejecute su aplicación en un emulador o dispositivo para generar tráfico. Espere unos minutos mientras su agente captura esos datos.

7. Vea sus datos para su aplicación de Android. Vaya a one.newrelic.com > All capabilities > Mobile > (select an app).

Configurar el agente de Android para el portal del complemento Gradle

Debido a que el agente de Android aún no está disponible como complemento comunitario, debe proporcionar el classpath a través de MavenCentral para que el agente pueda instrumentar su aplicación de Android. Si configuró su aplicación para buscar complementos a través del Portal de complementos de Gradle, debe repetir este paso en el archivo settings.gradle(.kts) .

1. Agregue este fragmento a su archivo settings.gradle(.kts) a través del bloque pluginManagement {} :

   pluginManagement {
     repositories {
       mavenCentral()  // adds repo for NewRelic artifacts
     }
     resolutionStrategy {
       eachPlugin {
         if (requested.id.id.startsWith("newrelic")) {
           useModule("com.newrelic.agent.android:agent-gradle-plugin:${AGENT_VERSION}")
         }
       }
     }
   
     // optional: define as a community plugin here or in root level build file
   
     // for core Gradle plugins or plugins already available to the build script
     plugins {
       id("newrelic") version "${<AGENT_VERSION>}"
     }
   }

   Copia

2. Declare el complemento New Relic:

   plugins {
     // for binary Gradle plugins that need to be resolved
     id("newrelic") version "<AGENT_VERSION>" apply false
   }

   Copia

3. Aplique el complemento a los archivos de compilación a nivel de aplicación:

   plugins {
       id("com.android.application")
       id("org.jetbrains.kotlin.android")
       id("newrelic")
   }

   Copia

En el fragmento anterior, <AGENT_VERSION> representa el número de versión de su agente. Le recomendamos encarecidamente que utilice el agente más reciente para la configuración.

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.

¿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.