Instalar el agente de Android

Agregue el complemento del agente de Android a su proyecto.

Respecto a la ubicación del complemento, tienes dos opciones:

• Recomendado: Uso del complemento Gradle DSL

  • A partir de la versión 7.6.0 del agente, el complemento del agente de Android está disponible en el Gradle Plugin Portal como un complemento de la comunidad. El complemento Gradle DSL simplifica la adición de dependencia de complementos a las aplicaciones.
  • Este método implica agregar el complemento agente dependencia al bloque DSL de complementos de su proyecto.

• ID de complemento heredado (newrelic)

  • Para proyectos más antiguos o casos de uso específicos, puede emplear el ID del complemento legacy .
  • Este método implica agregar el agente como dependencia al script de compilación de su proyecto, especificando el repositorio de MavenCentral.

  Siga los pasos detallados a continuación para el método de instalación elegido.

  (Recomendado) Aplicar el complemento mediante el bloque del DSL complemento

  El enfoque recomendado para gestionar la dependencia de complementos en Gradle emplea el bloque de DSL complementos. Esta sección detalla cómo aplicar la forma completa del ID del complemento (com.newrelic.agent.android) dentro de esta estructura.

  1. Declare el complemento New Relic en el archivo de nivel superior build.gradle(.kts) empleando el ID del complemento Portal del complemento Gradle:

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

     Copia

     Cerciorar de reemplazar AGENT_VERSION con el número de versión de su agente. Le recomendamos encarecidamente que emplee la última versión.

  2. Aplique el complemento explícitamente al archivo de compilación de nivel de aplicación (y cualquier submódulo destinado a la instrumentación) empleando la siguiente sintaxis:

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

     Copia

     Para obtener información detallada sobre la aplicación del complemento dentro de Gradle, consulte la documentación de Gradle.

  Aplicar el complemento mediante el bloque buildscript{}

  El complemento de agente de Android está disponible en MavenCentral y emplea el ID de complemento legacy newrelic para compatibilidad con proyectos más antiguos. Si decide aprovechar esta ID legacy para una aplicación existente, deberá configurar explícitamente la ruta de clase a MavenCentral. Esto garantiza que Gradle pueda localizar el complemento durante el proceso de compilación. Para obtener más detalles sobre los distintos métodos para resolver complementos, consulte la documentación de Gradle.

  Para preferir MavenCentral al complemento Gradle Portal, debe realizar los siguientes cambios en los archivos Gradle:

  1. Agregue este fragmento a su build.gradle(.kts) de nivel superior archivo:

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

     Copia

  2. 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 {
           // 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
       }
     }

     Copia

     Cerciorar de reemplazar AGENT_VERSION con el número de versión de su agente. Le recomendamos encarecidamente que emplee la última versión.

  3. Aplique el complemento al archivo de compilación de nivel de aplicación, así como a cualquier otro submódulo que se va a instrumentar:

     plugins {
       id("newrelic")
     }

     Copia

En su archivo AndroidManifest.xml , agregue las siguientes licencias:

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

En su clase principal Activity dentro del método onCreate , agregue esta declaración de importación:

import com.newrelic.agent.android.NewRelic;

Nota: Debe agregar esta declaración de importación a la clase Activity . No admitimos iniciar el agente en otras clases.

En el método onCreate , agregue la siguiente línea, cerciorar de reemplazar GENERATED_TOKEN con el token de su aplicación real (creado durante la instalación guiada):

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

(Opcional) Configuración adicional para Proguard/Dexguard

Si emplea ProGuard o Dexguard para reducir el código, siga estos pasos:

1. Crea un archivo newrelic.properties en tu directorio de nivel de aplicación (por ejemplo: /projectname/app/newrelic.properties).

2. En este nuevo archivo, agregue la siguiente línea, reemplazando GENERATED_TOKEN con su token real:

   com.newrelic.application_token=GENERATED_TOKEN

   Copia

3. Siga los pasos descritos en Configurar ProGuard o DexGuard para aplicaciones de Android.

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.

Vea los datos de su aplicación en New Relic yendo a one.newrelic.com > All capabilities > Mobile > (select an app).