Instale el complemento New Relic para aplicaciones instantáneas de Android

Las aplicaciones instantáneas de Android permiten al usuario utilizar rápidamente su aplicación sin instalación. Con la versión 5.17.0 y superior del agente de Android, puede utilizar New Relic para detectar e instrumentar todos los módulos característicos de una aplicación instantánea.

Utilice esta documentación junto con los procedimientos estándar de New Relic para instalar aplicaciones de Android con Gradle y Android Studio. Después de seguir los procedimientos de instalación estándar, siga estos pasos adicionales para aplicaciones instantáneas de Android.

Terminología

Este procedimiento utiliza los siguientes términos que son específicos del complemento Android Instant Apps:

• Module

  : Cualquier clase empaquetada y/o colección de recursos.

• APK

  : Un módulo que empaqueta los recursos de las aplicaciones y las clases DEX

• Feature module

  : un módulo reducido que contiene solo un subconjunto del APK total

Instalar el complemento

Para instalar el complemento New Relic para aplicaciones instantáneas de Android:

1. Primero siga los pasos de la documentación Instalar aplicaciones de Android con Gradle y Android Studio .

2. Aplique el complemento del agente en cada archivo de compilación de Gradle del proyecto.

3. Enumere el agente de Android como una dependencia.

4. Inicie el agente desde cada clase de Actividad en la característica que podría cargarse a través de una intención de Enlace de Activo Digital (por ejemplo, mobile.example.com/signin).

   Ejemplo mínimo de build.gradle

   apply plugin: 'com.android.[application|library|feature|instantapp]'
   apply plugin: 'newrelic'
   
   dependencies {
       implementation "com.newrelic.agent.android:android-agent:${project.agentVersion}"
   }

   Copia

5. Revisar las consideraciones para la instrumentación.

Instrumentación

Al instrumentar una aplicación instantánea, tenga en cuenta las siguientes consideraciones con los APK:

Soporte ProGuard y Dexguard

El complemento Android Studio Gradle ofuscará cualquier configuración de compilación donde minifyEnabled esté establecido en true. En estas condiciones, el agente de New Relic reenviará el mapa ProGuard generado para la compilación al recolector de fallas, etiqueta con una ID de compilación única generada por el agente.

La ofuscación se configura mejor en la aplicación o proyecto de aplicación instantánea que incluye otros módulos como dependencia. Los módulos pueden configurar ProGuard según sea necesario.

Solucionar problemas de instrumentación automática

Si no sabe si el agente está instrumentado automáticamente en un proyecto de aplicación instantánea, intente ejecutar estos pasos:

1. Compile la aplicación con la opción debug (-d, --debug) y capture el log de compilación.

2. Busque en el log evidencia de aplicaciones instantáneas buscando cualquiera de estos términos:

   • This appears to be an Instant App

     Copia

   • BuildId[1a2b34c5-def6-7890-g123-h4567890a]

     Copia

3. El agente agregará un atributo llamado 'instantApp' a los atributos de sesión de la aplicación si la aplicación parece ser una aplicación instantánea.