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 Integrations & Agents 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á empleando Unity 2019 o posterior, siga los pasos a continuación.

1. En la configuración de compilación de Gradle, deberá incluir la URL del repositorio Maven de New Relic . Para hacer esto, abra el archivo mainTemplate.gradle , que generalmente se encuentra en la carpeta Assets/Plugins/Android . Agrega el siguiente fragmento:

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

   Copia

2. En su archivo baseProjectTemplate.gradle (generalmente ubicado en la carpeta Android de su proyecto Unit), agregue New Relic classpath en el nivel del proyecto:

   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
   }

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

   Copia

   Si su proyecto emplea DSL complementario, realice los siguientes cambios (y omita el paso 3):

   En android/app/build.gradle:

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

   Copia

3. En su archivo launcherTemplate.gradle (generalmente ubicado en la carpeta Android de su proyecto Unity), aplique el complemento newrelic en la parte superior de su archivo launcherTemplate.gradle :

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

   Copia

4. En su archivo AndroidManifest.xml , agregue las siguientes licencias:

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