Unity モバイル アプリを監視する

要件を確認する

Unity エージェントをインストールする前に、Unity アプリが次のバージョン要件を満たしていることを確認してください。

• Android ネイティブ アプリの場合:

  • Android API 24 以上
  • Android ネイティブの要件を参照してください

• iOS ネイティブ アプリの場合:

  • iOS ネイティブの要件を参照してください

Unity エージェントをプロジェクトに追加する

Unity パッケージ マネージャーで、次の GitHub URL を追加します。

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

アプリケーショントークンを追加する

New Relic が Unity アプリのデータを認証できるようにするには、次の手順に従います。

1. New Relic からアプリケーション トークンを取得します。

   1. one.newrelic.comに移動し、 Integrations & Agentsをクリックしてから、 Mobileをクリックします。
   2. Unity アプリを選択します。
   3. Settings > Applicationに移動し、表示されたApplication tokenをコピーします。

2. トークンを Unity プロジェクトに追加します。

   1. Unity IDE を開きます。

   2. エディター ウィンドウを開くには、 Tools > New Relic > Getting Startedに移動します。

   3. アプリがサポートするプラットフォームごとに、適切なアプリケーション トークンを対応するフィールドに貼り付けます。

      • Android: Android トークンを「Android アプリ トークン」フィールドに貼り付けます。
      • iOS: iOS トークンを「iOS アプリ トークン」フィールドに貼り付けます。

      アプリが Android と iOS の両方で実行される場合は、プラットフォームごとに個別のトークンを提供します。両方に同じトークンを使用しないでください。

   

(Android のみ) Android アプリを構成する

Android アプリを構成するには、Gradle テンプレートをカスタマイズする必要があります。 Unity 2019 以降を使用している場合は、以下の手順に従ってください。

1. Gradle ビルド設定に、New Relic Maven リポジトリの URL を含める必要があります。 これを行うには、通常はAssets/Plugins/AndroidフォルダーにあるmainTemplate.gradleファイルを開きます。 次のスニペットを追加します。

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

   コピー

2. baseProjectTemplate.gradleファイル (通常は Unit プロジェクトの Android フォルダーにあります) で、プロジェクト レベルで New Relic classpathを追加します。

   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
   }

   コピー

   Gradle 7.0 以下を必要とする古い 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 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
   }

   コピー

   プロジェクトでプラグイン DSL を使用している場合は、次の変更を加えます (手順 3 はスキップします)。

   android/app/build.gradle 内:

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

   コピー

3. launcherTemplate.gradleファイル（通常は Unity プロジェクトの Android フォルダーにあります）で、 newrelicプラグインをlauncherTemplate.gradleファイルの先頭に適用します。

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

   コピー

4. AndroidManifest.xmlファイルに次の権限を追加します。

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

   コピー

(iOS のみ) 依存関係を管理する

iOS の場合は、外部依存関係マネージャーの設定を確認します。

1. Unity IDE で、 Assetsに移動し、 External Dependency Managerを開きます。

2. iOS Resolverをクリックします。

3. 「Podfile Configurations」セクションで、次の設定を確認します。

   • Add use_frameworks! to Podfile 無効になっています
   • Always add the main target to Podfile 有効になっています
   

4. iOS の依存関係管理に Podfile を使用していない場合は、次の手順に従います。

   1. New Relic XCFramework SDK (iOS エージェント) をダウンロードして解凍します。最新の iOS エージェントは、 iOS エージェントのリリース ノートから入手できます。

   2. New Relic XCFramework を Xcode プロジェクトに追加します。

      1. SDK ダウンロードを解凍します。
      2. Finder から、 NewRelicAgent.xcframeworkフォルダを Xcode プロジェクトにドラッグし、Targets Frameworks ペインに配置します。
      3. Embed列の下にあるEmbed & Signをクリックします。

   そして、あなたは完了です！5 分以内に New Relic でデータが表示されるようになります。