Instale o agente Android

Adicione o plug-in Android agente ao seu projeto.

Em relação à localização do plug-in, você tem duas opções:

• Recomendado: Usando o plug-in Gradle DSL

  • A partir da versão 7.6.0 do agente, o plug-in do Android agente está disponível no Gradle Plugin Portal como um plug-in da comunidade. O plug-in DSL do Gradle simplifica a adição de dependência de plug-ins aos aplicativos.
  • Este método envolve adicionar o plug-in agente dependência ao bloco DSL do plug-in do seu projeto.

• ID do plug-in legado (newrelic)

  • Para projetos mais antigos ou casos de uso específicos, você pode usar o ID do plug-in legado.
  • Este método envolve adicionar o agente como uma dependência ao script de compilação do seu projeto, especificando o repositório MavenCentral.

  Siga as etapas detalhadas abaixo para o método de instalação escolhido.

  (Recomendado) Aplique o plug-in usando o bloco do DSL plug-in

  A abordagem recomendada para gerenciar dependência de plug-ins no Gradle utiliza o bloco de DSL plug-ins. Esta seção detalha a aplicação do formato totalmente qualificado do ID do plug-in (com.newrelic.agent.android) dentro desta estrutura.

  1. Declare o plug-in New Relic no arquivo build.gradle(.kts) de nível superior usando o ID do plug-in do Portal do plug-in Gradle:

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

     Copiar

     Certifique-se de substituir AGENT_VERSION pelo número da versão do seu agente. Recomendamos fortemente que você use a versão mais recente.

  2. Aplique o plug-in explicitamente ao arquivo de compilação no nível do aplicativo (e quaisquer submódulos destinados à instrumentação) usando a seguinte sintaxe:

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

     Copiar

     Para obter informações detalhadas sobre como aplicar o plug-in no Gradle, consulte a documentação do Gradle.

  Aplique o plug-in usando o bloco buildscript{}

  O plug-in Android agente está disponível no MavenCentral e usa o ID do plug-in legado newrelic para compatibilidade com projetos mais antigos. Se você optar por aproveitar esse ID legado para um aplicativo existente, precisará configurar explicitamente o classpath para o MavenCentral. Isso garante que o Gradle possa localizar o plug-in durante o processo de compilação. Para mais detalhes sobre vários métodos de resolução de plug-ins, consulte a documentação do Gradle.

  Para preferir o MavenCentral ao Portal do plug-in Gradle, você precisa fazer as seguintes alterações nos arquivos Gradle:

  1. Adicione este trecho ao seu build.gradle(.kts) de nível superior arquivo:

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

     Copiar

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

     Copiar

     Certifique-se de substituir AGENT_VERSION pelo número da versão do seu agente. Recomendamos fortemente que você use a versão mais recente.

  3. Aplique o plug-in ao arquivo de compilação no nível do aplicativo, bem como a qualquer outro submódulo a ser instrumentado:

     plugins {
       id("newrelic")
     }

     Copiar

No seu arquivo AndroidManifest.xml , adicione as seguintes permissões:

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

Na sua classe principal Activity dentro do método onCreate , adicione esta instrução de importação:

import com.newrelic.agent.android.NewRelic;

Observação: você deve adicionar esta instrução de importação à classe Activity . Não oferecemos suporte para iniciar o agente em outras classes.

No método onCreate , adicione a seguinte linha, certificando-se de substituir GENERATED_TOKEN pelo seu token de aplicativo real (criado durante a instalação guiada):

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

(Opcional) Configuração adicional para Proguard/Dexguard

Se você usar ProGuard ou Dexguard para redução de código, siga estas etapas:

1. Crie um arquivo newrelic.properties no diretório de nível de aplicativo (ex: /projectname/app/newrelic.properties).

2. Neste novo arquivo, adicione a seguinte linha, substituindo GENERATED_TOKEN pelo seu token real:

   com.newrelic.application_token=GENERATED_TOKEN

   Copiar

3. Siga as etapas descritas em Configurar ProGuard ou DexGuard para aplicativos Android.

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.

Visualize os dados do seu aplicativo no New Relic acessando one.newrelic.com > All capabilities > Mobile > (select an app).