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 Integrations & Agents 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, siga as etapas abaixo.

1. Nas configurações de compilação do Gradle, você precisará incluir a URL do repositório Maven do New Relic. Para fazer isso, abra seu arquivo mainTemplate.gradle , que geralmente está localizado na pasta Assets/Plugins/Android . Adicione o seguinte trecho:

   allprojects {
     buildscript {
       repositories {
         ARTIFACTORY_REPOSITORY
         google()
         jcenter()
         mavenCentral()
       }
     }
   }

   Copiar

2. No seu arquivo baseProjectTemplate.gradle (geralmente localizado na pasta Android do seu projeto Unit), adicione o New Relic classpath no nível do projeto:

   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'
     BUILD_SCRIPT_DEPS
   }

   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'
     BUILD_SCRIPT_DEPS
   }

   Copiar

   Se o seu projeto estiver usando plug-in DSL, faça as seguintes alterações (e pule a etapa 3):

   Em android/app/build.gradle:

   plugins {
       id "com.android.application"
       id "kotlin-android"
       id "com.newrelic.agent.android" version "7.5.1"  //<-- include this
   }

   Copiar

3. No seu arquivo launcherTemplate.gradle (geralmente localizado na pasta Android do seu projeto Unity), aplique o plug-in newrelic na parte superior do seu arquivo launcherTemplate.gradle :

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

   Copiar

4. 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" />

   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.