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にアクセスし、 [データを追加]をクリックし、 [モバイル]をクリックします。
   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. New Relic Maven リポジトリ URL を Gradle ビルド設定に含めます。これを行うには、 mainTemplate.gradleファイルを開きます。このファイルは通常、 Assets/Plugins/Android folderにあります。次に、次のように New Relic Maven URL を開きます。

   allprojects {
   buildscript {
       repositories {**ARTIFACTORYREPOSITORY**
           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 [iOS リゾルバー]をクリックします。

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