• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

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.

  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" />
  3. Inicie o agente Android. Na atividade padrão encontrada no manifesto, importe a classe NewRelic :

    import com.newrelic.agent.android.NewRelic;

    Não oferecemos suporte para iniciar o agente em 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());
  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 (projectname/app). Esta etapa se aplica apenas ao usuário ProGuard e DexGuard.

    com.newrelic.application_token=GENERATED_TOKEN

    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}"
    }
    }
  2. Declare o plug-in New Relic:

    plugins {
    // for binary Gradle plugins that need to be resolved
    id("newrelic") version "AGENT_VERSION" apply false
    }
  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")
    }

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:

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.