Monitor tu aplicación móvil de Unity

Revisa los requisitos

Antes de instalar el agente de Unity, asegúrese de que su aplicación de Unity cumpla con estos requisitos de versión:

• Para aplicaciones nativas de Android:

  • API de Android 24 o superior
  • Ver los requisitos nativos de Android

• Para aplicaciones nativas de iOS:

  • Ver requisitos nativos de iOS

Agrega el agente de Unity a tu proyecto

En el administrador de paquetes de Unity, agregue la siguiente URL de GitHub:

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

Agregar token(s) de aplicación

Para permitir que New Relic autentique los datos de su aplicación Unity, siga estos pasos:

1. Obtenga su token de aplicación de New Relic:

   1. Vaya a

      one.newrelic.com

      , haga clic en

      Add data

      y luego haga clic en

      Mobile

      .

   2. Seleccione su aplicación Unity.

   3. Vaya a

      Settings > Application

      y copie el

      Application token

      mostrado.

2. Agrega el token a tu proyecto de Unity:

   1. Abra su IDE de Unity.

   2. Vaya a Tools > New Relic > Getting Started para abrir la ventana del editor.

   3. Pegue el token de aplicación apropiado en el campo correspondiente para cada plataforma que admita su aplicación:

      • Android: pegue el token de Android en el campo "Token de aplicación de Android".
      • iOS: pegue el token de iOS en el campo "Token de aplicación iOS".

      Si su aplicación se ejecuta tanto en Android como en iOS, proporcione un token independiente para cada plataforma. No utilices el mismo token para ambos.

   

(Solo para Android) Configura tu aplicación de Android

Para configurar su aplicación de Android, necesita personalizar sus plantillas de Gradle. Si está utilizando Unity 2019 o posterior, complete los siguientes pasos:

1. Incluya la URL del repositorio de New Relic Maven en la configuración de compilación de Gradle. Para hacer esto, abra su archivo mainTemplate.gradle . Este archivo normalmente se encuentra en el Assets/Plugins/Android folder. Ahora, abra la URL de New Relic Maven así:

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

   Copia

2. Agregue la New Relic classpath a su archivo baseProjectTemplate.gradle a nivel de proyecto. Generalmente puedes encontrar este archivo ubicado en la carpeta de Android en tu proyecto de 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>
       }
   }

   Copia

   Si estás usando una versión anterior de Unity que requiere Gradle 7.0 o inferior, necesitarás usar una dependencia de classpath específica para garantizar la compatibilidad:

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

   Copia

3. Aplique el complemento newrelic en la parte superior de su archivo launcherTemplate.gradle . Este archivo normalmente se encuentra en la carpeta de Android de su proyecto de Unity.

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

   Copia

4. Agregue permisos INTERNET y ACCESS_NETWORK_STATE en su archivo AndroidManifest.xml :

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

   Copia

(solo iOS) Administrar dependencia

Para iOS, verifique la configuración de su Administrador de dependencias externas:

1. En su IDE de Unity, vaya a Assets y abra External Dependency Manager.

2. Haga clic en iOS Resolver.

3. En la sección de configuración de Podfile, verifique estas configuraciones:

   • Add use_frameworks! to Podfile

     está desactivado

   • Always add the main target to Podfile

     está habilitado

   

4. Si no estás utilizando Podfile para la gestión de dependencias de iOS, sigue estos pasos:

   1. Descargue y descomprima el SDK de New Relic XCFramework (agente de iOS). Puede obtener el agente iOS más reciente en nuestras notas de la versión del agente iOS.

   2. Agregue New Relic XCFramework a su proyecto Xcode:

      1. Descomprima la descarga del SDK.

      2. Desde su Finder, arrastre la carpeta NewRelicAgent.xcframework a su proyecto Xcode y colóquela en el panel de su marco objetivo.

      3. Debajo de la columna

         Embed

         , haga clic en

         Embed & Sign

         .

   ¡Y tu estas listo! Deberías empezar a ver datos en New Relic en 5 minutos.