Monitor your Unity mobile app

Review the requirements

Before you install the Unity agent, make sure your Unity app meets these version requirements:

• For Android-native apps:
  • Android API 24 or higher
  • See Android-native requirements
• For iOS-native apps:
  • See iOS-native requirements

Add the Unity agent to your project

In the Unity package manager, add the following GitHub URL:

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

Add application token(s)

To enable New Relic to authenticate your Unity app's data, follow these steps:

1. Get your application token from New Relic:

   1. Go to one.newrelic.com, click Add data, then click Mobile.
   2. Select your Unity app.
   3. Go to Settings > Application and copy the displayed Application token.

2. Add the token to your Unity project:

   1. Open your Unity IDE.

   2. Go to Tools > New Relic > Getting Started to open the editor window.

   3. Paste the appropriate application token into the corresponding field for each platform your app supports:

      • Android: Paste the Android token into the "Android App Token" field.
      • iOS: Paste the iOS token into the "iOS App Token" field.

   If your app runs on both Android and iOS, provide separate tokens for each platform. Do not use the same token for both.

(Android-only) Configure your Android app

To configure your Android app you need to customize your Gradle templates. If you're using Unity 2019 or later, complete the following steps:

1. Include the New Relic Maven repository URL in the Gradle build settings. To do this, open your mainTemplate.gradle file. This file is usually located in the Assets/Plugins/Android folder. Now, open the New Relic Maven URL like this:

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

   Copy

2. Add the New Relic classpath to your project-level baseProjectTemplate.gradle file. You can usually find this file located in the Android folder in your Unity project.

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

   Copy

   If you're using an older Unity version that requires Gradle 7.0 or lower, you'll need to use a specific classpath dependency to ensure compatibility:

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

   Copy

3. Apply the newrelic plugin to the top of your launcherTemplate.gradle file. This file is typically located in the Android folder of your Unity project.

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

   Copy

4. Add INTERNET and ACCESS_NETWORK_STATE permissions in your AndroidManifest.xml file:

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

   Copy

(iOS-only) Manage dependencies

For iOS, check your External Dependency Manager settings:

1. In your Unity IDE, go to Assets and open the External Dependency Manager.

2. Click iOS Resolver.

3. In the Podfile Configurations section, verify these settings:

   • Add use_frameworks! to Podfile is disabled
   • Always add the main target to Podfile is enabled

4. If you're not using the Podfile for iOS dependency management, follow these steps:

   1. Download and unzip the New Relic XCFramework SDK (iOS agent). You can get the latest iOS agent from our iOS agent release notes.
   2. Add the New Relic XCFramework to your Xcode project:
      1. Unzip the SDK download.
      2. From your Finder, drag the NewRelicAgent.xcframework folder into your Xcode project, placing it onto your Targets Frameworks pane.
      3. Under the Embed column, click Embed & Sign.

And you're done! You should start seeing data in New Relic within 5 minutes.