Para instalar o agente Android, recomendamos que você siga nossa instalação guiada:
- Vá para one.newrelic.com > Integrations & Agents > Mobile > Android.
- Siga as etapas de instalação guiada para configurar seu agente Android.
- Aguarde alguns minutos e visualize seus dados acessando one.newrelic.com > All capabilities > Mobile > (select your app).
Instale manualmente o agente Android
As etapas abaixo estão descritas em nossa instalação guiada. Observe que, mesmo se você instalar o agente manualmente, ainda precisará criar um aplicativo New Relic e obter o token de aplicativo gerado. Este token é essencial para que o agente envie dados para o New Relic.
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 agente Android está disponível no Gradle Plugin Portal como um plug-in da comunidade. A DSL do plug-in do Gradle simplifica a adição de dependência de plug-in 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.
Importante
New Relic adiciona automaticamente as seguintes permissões para permitir que o agente faça requests HTTP para entregar dados capturados para as versões 7.6.8 do agente e superior.
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" />Inicie o agente no método onCreate() da sua classe Application, para que o agente esteja em execução antes que o Android crie qualquer Activity, independentemente de em qual Activity o seu aplicativo abra.
Se o seu aplicativo já tiver uma subclasse Application, adicione a instrução de importação e a chamada start() abaixo a ela. Se o seu aplicativo não tiver uma, crie-a:
import android.app.Application;import com.newrelic.agent.android.NewRelic;
public class MyApplication extends Application { @Override public void onCreate() { super.onCreate(); NewRelic.withApplicationToken("GENERATED_TOKEN").start(this); }}Certifique-se de substituir GENERATED_TOKEN pelo token do seu aplicativo (você o gera ao criar o seu aplicativo no New Relic).
Se você criou uma nova classe Application, registre-a no seu AndroidManifest.xml adicionando o atributo android:name ao elemento <application>:
<application android:name=".MyApplication" ... >Sem esta etapa, o Android não cria sua classe, e o agente não inicia.
Use o nome de classe totalmente qualificado ou um nome que comece com um ponto (por exemplo, .MyApplication), que o Android resolve em relação ao pacote do seu aplicativo.
(Opcional) Configuração adicional para Proguard/Dexguard
Se você usar ProGuard ou Dexguard para redução de código, siga estas etapas:
Crie um arquivo
newrelic.propertiesno diretório de nível de aplicativo (ex:/projectname/app/newrelic.properties).Neste novo arquivo, adicione a seguinte linha, substituindo
GENERATED_TOKENpelo seu token real:com.newrelic.application_token=GENERATED_TOKEN
Importante
O New Relic adiciona automaticamente as regras do ProGuard para a versão 7.6.8 do agente e depois.
- 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).
Escolha onde iniciar o agente
Recomendamos iniciar o agente a partir de Application.onCreate(). O Android cria a sua classe Application antes de qualquer Activity, portanto, o agente é executado independentemente de o seu aplicativo abrir no Activity de lançamento habitual ou em um diferente, por exemplo, a partir de uma notificação push, um deep link, um atalho de aplicativo ou um widget.
Você ainda pode iniciar o agente no método onCreate() de um Activity. Se você fizer isso, o agente será executado apenas para lançamentos que atingirem esse Activity. Se você mover a chamada start() para a sua classe Application, remova-a do seu Activity.
Tenha o seguinte em mente:
- Inicie o agente uma vez. O agente ignora qualquer chamada para
start()enquanto já está em execução, portanto, deixar a chamada em ambos os lugares não inicia o agente duas vezes. - O Android executa
Application.onCreate()em cada processo que o seu aplicativo declara. Se algum dos seus componentes definirandroid:process, o agente também será iniciado em cada um desses processos, e cada um relatará a sua própria sessão. Inicie o agente apenas quando o seu código estiver em execução no processo principal do seu aplicativo. start()lê e grava arquivos pequenos na thread de chamada, de modo que o StrictMode possa relatar o acesso ao disco na thread principal onde quer que você o chame.
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.
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.