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 を含めます。 これを行うには、 mainTemplate.gradleファイルを開きます。 このファイルは通常、 Assets/Plugins/Androidフォルダーにあります。 次に、次のように New Relic Maven URL を開きます。

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

   コピー

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

   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
   }

   コピー

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

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

   コピー

4. AndroidManifest.xml ファイルに INTERNET および ACCESS_NETWORK_STATE 権限を追加します。

   <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 でデータが表示されるようになります。