Monitor seu aplicativo móvel Unity

Revise os requisitos

Antes de instalar o agente Unity, certifique-se de que seu aplicativo Unity atenda a estes requisitos de versão:

• Para aplicativos nativos do Android:

  • API Android 24 ou superior
  • Veja os requisitos nativos do Android

• Para aplicativos nativos do iOS:

  • Veja os requisitos nativos do iOS

Adicione o agente Unity ao seu projeto

No gerenciador de pacote Unity, adicione o seguinte URL do GitHub:

https://github.com/newrelic/newrelic-unity-agent.git

Adicionar token(s) de aplicativo

Para permitir que o New Relic autentique os dados do seu aplicativo Unity, siga estas etapas:

1. Obtenha seu token de aplicativo da New Relic:

   1. Vá para

      one.newrelic.com

      , clique em

      Add data

      e depois clique em

      Mobile

      .

   2. Selecione seu aplicativo Unity.

   3. Vá para

      Settings > Application

      e copie o

      Application token

      exibido.

2. Adicione o token ao seu projeto Unity:

   1. Abra seu IDE Unity.

   2. Vá para Tools > New Relic > Getting Started para abrir a janela do editor.

   3. Cole o token de aplicativo apropriado no campo correspondente para cada plataforma compatível com seu aplicativo:

      • Android: cole o token do Android no campo "Android App Token".
      • iOS: cole o token do iOS no campo "iOS App Token".

      Se seu aplicativo for executado em Android e iOS, forneça um token separado para cada plataforma. Não use o mesmo token para ambos.

   

(Somente Android) Configure seu aplicativo Android

Para configurar seu aplicativo Android, você precisa personalizar seus modelos Gradle. Se você estiver usando o Unity 2019 ou posterior, conclua as seguintes etapas:

1. Inclua o URL do repositório New Relic Maven nas configurações de compilação do Gradle. Para fazer isso, abra seu arquivo mainTemplate.gradle . Este arquivo geralmente está localizado em Assets/Plugins/Android folder. Agora, abra o URL do New Relic Maven assim:

   allprojects {
   buildscript {
       repositories {<DoNotTranslate>**ARTIFACTORYREPOSITORY**</DoNotTranslate>
           google()
           jcenter()
           mavenCentral()
       }
   }

   Copiar

2. Adicione a New Relic classpath ao arquivo baseProjectTemplate.gradle no nível do projeto. Geralmente você pode encontrar esse arquivo localizado na pasta Android do seu projeto Unity.

   dependencies {
       // If you are changing the Android Gradle Plugin version, make sure it is compatible with the Gradle version preinstalled with Unity.
       // See which Gradle version is preinstalled with Unity here: https://docs.unity3d.com/Manual/android-gradle-overview.html
       // See the official Gradle and Android Gradle Plugin compatibility table here: https://developer.android.com/studio/releases/gradle-plugin#updating-gradle
       // To specify a custom Gradle version in Unity, go to "Preferences > External Tools", uncheck "Gradle Installed with Unity (recommended)", and specify a path to a custom Gradle version.
       classpath 'com.newrelic.agent.android:agent-gradle-plugin:7.2.0'
       <DoNotTranslate>**BUILD_SCRIPT_DEPS**</DoNotTranslate>
       }
   }

   Copiar

   Se estiver usando uma versão mais antiga do Unity que requer Gradle 7.0 ou inferior, você precisará usar uma dependência de classpath específica para garantir a compatibilidade:

   dependencies {
       // If you are changing the Android Gradle Plugin version, make sure it is compatible with the Gradle version preinstalled with Unity.
       // See which Gradle version is preinstalled with Unity here: https://docs.unity3d.com/Manual/android-gradle-overview.html
       // See official Gradle and Android Gradle Plugin compatibility table here: https://developer.android.com/studio/releases/gradle-plugin#updating-gradle
       // To specify a custom Gradle version in Unity, go to "Preferences > External Tools", uncheck "Gradle Installed with Unity (recommended)", and specify a path to a custom Gradle version.
       classpath 'com.newrelic.agent.android:agent-gradle-plugin:6.11.0'
       <DoNotTranslate>**BUILD_SCRIPT_DEPS**</DoNotTranslate>
   }

   Copiar

3. Aplique o plug-in newrelic na parte superior do arquivo launcherTemplate.gradle . Esse arquivo normalmente está localizado na pasta Android do seu projeto Unity.

   apply plugin: "com.android.application"
   apply plugin: 'newrelic' // <-- add this

   Copiar

4. Adicione as permissões INTERNET e ACCESS_NETWORK_STATE ao seu arquivo AndroidManifest.xml :

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

   Copiar

(somente iOS) Gerenciar dependência

Para iOS, verifique as configurações do Gerenciador de Dependência Externa:

1. No seu IDE Unity, vá para Assets e abra o External Dependency Manager.

2. Clique em iOS Resolver.

3. Na seção Configuração do Podfile, verifique estas configurações:

   • Add use_frameworks! to Podfile

     está desabilitado

   • Always add the main target to Podfile

     está ativado

   

4. Se você não estiver usando o Podfile para gerenciamento de dependências do iOS, siga estas etapas:

   1. Baixe e descompacte o SDK New Relic XCFramework (agente iOS). Você pode obter o agente iOS mais recente em nossas notas de versão do agente iOS.

   2. Adicione o New Relic XCFramework ao seu projeto Xcode:

      1. Descompacte o download do SDK.

      2. No Finder, arraste a pasta NewRelicAgent.xcframework para o projeto Xcode, colocando-a no painel da estrutura de destino.

      3. Na coluna

         Embed

         , clique em

         Embed & Sign

         .

   E pronto! Você deverá começar a ver os dados no New Relic em 5 minutos.