Instale o agente Android

Para instalar o agente Android, você precisa usar nossa instalação guiada. A configuração do agente Android requer um token de aplicativo que autentique cada aplicativo móvel que você deseja monitor. O token do aplicativo só está disponível por meio da instalação guiada.

Instale o agente Android com instalação guiada

1. Vá para

   one.newrelic.com > Add data > Mobile > Android

   .

2. Siga as etapas de instalação guiada para configurar seu agente Android.

3. Aguarde alguns minutos e visualize seus dados acessando

   one.newrelic.com > All capabilities > Mobile > (select your app)

   .

Instale manualmente o agente Android

Esses procedimentos aparecem em nossa instalação guiada. Tenha em mente que mesmo se você estiver atualizando seus arquivos de compilação através dos documentos, você ainda precisará adicionar seu aplicativo ao New Relic e obter o token de aplicativo gerado na instalação guiada. Caso contrário, você não poderá capturar dados sobre seus aplicativos Android.

1. Adicione o código a seguir aos arquivos build.gradle encontrados na guia Gradle e Android Studio. Você precisa atualizar o trecho de construção de nível superior e cada submódulo que deseja instrumentalizar.

   Nível do projeto `build.gradle` arquivo:

   Neste exemplo, <AGENT_VERSION> representa o número da versão do seu agente. Consulte as notas de versão do agente e use a versão mais recente.

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

   Copiar

   Nível do aplicativo `build.gradle` arquivo:

   Neste exemplo, <AGENT_VERSION> representa o número da versão do seu agente. Consulte as notas de versão do agente e use a versão mais recente.

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

   Copiar

2. Defina permissões de aplicativos. Certifique-se de que seu aplicativo Android solicite as permissões INTERNET e ACCESS_NETWORK_STATE adicionando estas linhas ao seu arquivo AndroidManifest.xml :

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

   Copiar

3. Inicie o agente Android. Na atividade padrão encontrada no manifesto, importe a classe NewRelic :

   import com.newrelic.agent.android.NewRelic;

   Copiar

   Não oferecemos suporte para iniciar o agente monitoramento de mobileem outras classes, pois isso pode causar comportamento inesperado ou instável.

4. Depois de importar a classe NewRelic , você precisa adicionar um trecho adicional ao método onCreate() , que inclui o token do seu aplicativo, que é gerado na instalação guiada. O trecho fica assim:

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

   Copiar

5. Se você estiver usando minificação (por exemplo, como com ProGuard ou Dexguard), será necessário adicionar o arquivo newrelic.properties ao diretório no nível do aplicativo (nome do projeto/app). Esta etapa se aplica apenas ao usuário ProGuard e DexGuard.

   com.newrelic.application_token=<GENERATED_TOKEN>

   Copiar

   Para concluir a configuração para minificação, siga as etapas em configurar ProGuard ou DexGuard para aplicativos Android.

6. Limpe seu projeto e execute seu aplicativo em um emulador ou dispositivo para gerar tráfego. Aguarde alguns minutos enquanto seu agente captura esses dados.

7. Visualize os dados do seu aplicativo Android. Vá para one.newrelic.com > All capabilities > Mobile > (select an app).

Configurar o agente Android para o portal do plug-in Gradle

Como o agente Android ainda não está disponível como plug-in de comunidade, você precisa fornecer o caminho de classe por meio do MavenCentral para que o agente possa instrumentar seu aplicativo Android. Se você configurou seu aplicativo para procurar plug-ins por meio do Portal de plug-ins do Gradle, será necessário repetir essa etapa no arquivo settings.gradle(.kts) .

1. Adicione este trecho ao seu arquivo settings.gradle(.kts) através do bloco 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>}"
     }
   }

   Copiar

2. Declare o plug-in New Relic:

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

   Copiar

3. Aplique o plug-in aos arquivos de compilação no nível do aplicativo:

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

   Copiar

No trecho acima, <AGENT_VERSION> representa o número da versão do seu agente. Recomendamos fortemente que você use o agente mais recente para configuração.

Android 4.x: suporte Multidex

O monitoramento de Mobile para versões do Android anteriores ao Android 5.0 (API nível 21) usa o tempo de execução Dalvik para executar o código do aplicativo. Por padrão, a Dalvik limita os aplicativos a um único arquivo de classes.dex bytecode por APK. Para contornar essa limitação, você deve ativar o suporte multidex. Em seguida, você pode usar a biblioteca de suporte multidex, que se torna parte do arquivo DEX principal do seu aplicativo. A biblioteca gerencia o acesso aos arquivos DEX adicionais e ao código que os contém.

Qual é o próximo?

Parabéns! Você instalou com sucesso o agente Android. Você tem algumas opções para as próximas etapas:

• Configure o comportamento do agente durante compilações do Gradle com o plug-in New Relic Gradle.
• Atualize o SDK do agente Android para manter seu agente Android atualizado.
• Está tendo problemas com a instalação do Android? Siga os procedimentos de resolução de problemas.