Instale o plug-in New Relic para Android Instant Apps

Os Instant Apps Android permitem que o usuário use seu aplicativo rapidamente sem instalação. Com o agente Android versão 5.17.0 e superior, você pode usar o New Relic para detectar e instrumentar todos os módulos de recursos de um aplicativo instantâneo.

Use esta documentação junto com os procedimentos padrão do New Relic para instalar aplicativos Android com Gradle e Android Studio. Depois de seguir os procedimentos de instalação padrão, siga estas etapas adicionais para aplicativos instantâneos Android.

Terminologia

Este procedimento usa os seguintes termos específicos do plug-in Android Instant Apps:

• Module

  : Qualquer classe empacotada e/ou coleção de recursos

• APK

  : Um módulo que empacota os recursos do aplicativo e as classes DEX

• Feature module

  : um módulo reduzido que contém apenas um subconjunto do APK total

Instale o plug-in

Para instalar o plug-in New Relic para Android Instant Apps:

1. Primeiro, siga as etapas na documentação Instalar aplicativos Android com Gradle e Android Studio .

2. Aplique o plug-in do agente em cada arquivo de compilação do projeto Gradle.

3. Liste o agente Android como uma dependência.

4. Inicie o agente de cada classe de atividade no recurso que pode ser carregado lateralmente por meio de uma intenção do Digital Asset Link (por exemplo, mobile.example.com/signin).

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

   Copiar

5. Revise as considerações para instrumentação.

Instrumentação

Ao usar um aplicativo instantâneo, esteja ciente das seguintes considerações com APKs:

Suporte ProGuard e Dexguard

O plug-in do Android Studio para Gradle ofuscará qualquer configuração de compilação em que minifyEnabled esteja definido como true. Nessas condições, o agente New Relic encaminhará o mapa ProGuard gerado para o build para o crash coletor, tag com um ID de build exclusivo gerado pelo agente.

A ofuscação é melhor configurada no aplicativo ou projeto de aplicativo instantâneo que inclui outros módulos como dependência. Os módulos podem configurar o ProGuard conforme necessário.

Solucionar problemas de instrumentação automática

Se você não sabe se o agente está instrumentando automaticamente um projeto de aplicativo instantâneo, tente executar estas etapas:

1. Crie o aplicativo com a opção debug (-d, --debug) e capture o log de compilação.

2. Pesquise no log evidências de aplicativos instantâneos procurando um destes termos:

   • This appears to be an Instant App

     Copiar

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

     Copiar

3. O agente adicionará um atributo chamado 'instantApp' aos atributos de sessão do aplicativo se o aplicativo parecer ser um aplicativo instantâneo.