Androidエージェントのインストール

Androidエージェントをインストールするには、ガイド付きインストールを使用する必要があります。Androidエージェントを設定するには、監視する各モバイルアプリを認証するアプリケーショントークンが必要です。このアプリトークンは、ガイド付きインストールを実行する場合にのみ使用できます。

ガイド付きインストールによるAndroidエージェントのインストール

1. one.newrelic.com > Add data > Mobile > Android

   に移動します。

2. ガイド付きインストール手順に従って、Androidエージェントを設定します

3. 数分待ってから、

   one.newrelic.com > All capabilities > Mobile > (select your app)

   に移動してデータを表示します。

Androidエージェントの手動インストール

これらの手順は、ガイド付きインストールに記載されています。ドキュメントからビルドファイルを更新している場合でも、アプリをNew Relicに追加し、ガイド付きインストールから生成されたアプリトークンを取得する必要があることに注意してください。そうしない場合、Androidアプリに関するデータを取得できません。

1. [Gradle & Android Studio]タブにあるbuild.gradleファイルに次のコードを追加します。最上位のビルドスニペットと、インストゥルメントする各サブモジュールを更新する必要があります。

   プロジェクトレベルの「build.gradle」ファイル：

   この例では、<AGENT_VERSION>エージェントのバージョン番号を表しています。エージェントリリースノートを参照し、最新版を使用してください。

   buildscript {
     repositories {
       mavenCentral()
     }
   
     dependencies {
       classpath "com.newrelic.agent.android:agent-gradle-plugin:<AGENT_VERSION>"
     }
   }

   コピー

   アプリレベルの「build.gradle」ファイル：

   この例では、<AGENT_VERSION>エージェントのバージョン番号を表しています。エージェントリリースノートを参照し、最新版を使用してください。

   repositories {
     mavenCentral()
   }
   
   apply plugin: 'android'
   apply plugin: 'newrelic'
   
   dependencies {
     implementation 'com.newrelic.agent.android:android-agent:<AGENT_VERSION>'
   }

   コピー

2. アプリケーションのアクセス権限を設定します。AndroidManifest.xmlファイルに以下の行を追加して、AndroidアプリがINTERNETおよびACCESS_NETWORK_STATE権限を要求するようにします。

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

   コピー

3. Androidエージェントを起動します。マニフェストにあるデフォルトのアクティビティで、NewRelicクラスをインポートします。

   import com.newrelic.agent.android.NewRelic;

   コピー

   想定外の動作や不安定な動作が生じる可能性があるため、他のクラスでのモバイル監視エージェントの起動はサポートされていません。

4. NewRelicクラスをインポートした後、ガイド付きインストールで生成されるアプリトークンを含む追加のスニペットをonCreate()メソッドに追加する必要があります。スニペットは次のようになります。

   NewRelic.withApplicationToken("<GENERATED_TOKEN>").start(this.getApplicationContext());

   コピー

5. 縮小（ProGuardやDexguardなど）を使用している場合は、newrelic.propertiesファイルをアプリレベルのディレクトリ (projectname/app）に追加する必要があります。この手順は、ProGuardおよびDexGuardユーザーにのみ適用されます。

   com.newrelic.application_token=<GENERATED_TOKEN>

   コピー

   縮小の設定を完了するには、Androidアプリ用のProGuardまたはDexGuardの設定の手順に従います。

6. プロジェクトをクリーンにし、エミュレーターまたはデバイスでアプリケーションを実行しトラフィックを発生させます。エージェントがそのデータを取得するまで数分間待ちます。

7. Androidアプリのデータを表示します。one.newrelic.com > All capabilities > Mobile > (select an app)に移動します。

Gradle Plugin Portal用のAndroidエージェントの設定

Androidエージェントはまだコミュニティプラグインとして利用できないため、エージェントがAndroidアプリをインストゥルメントできるように、MavenCentralを通じてクラスパスを指定する必要があります。Gradle Plugin Portalを通じてプラグインを検索するようにアプリを設定した場合は、settings.gradle(.kts)ファイルでこの手順を繰り返す必要があります。

1. このスニペットを、pluginManagement {}ブロックを介してsettings.gradle(.kts)ファイルに追加します

   pluginManagement {
     repositories {
       mavenCentral()  // adds repo for NewRelic artifacts
     }
     resolutionStrategy {
       eachPlugin {
         if (requested.id.id.startsWith("newrelic")) {
           useModule("com.newrelic.agent.android:agent-gradle-plugin:${AGENT_VERSION}")
         }
       }
     }
   
     // optional: define as a community plugin here or in root level build file
   
     // for core Gradle plugins or plugins already available to the build script
     plugins {
       id("newrelic") version "${<AGENT_VERSION>}"
     }
   }

   コピー

2. New Relicプラグインを宣言します

   plugins {
     // for binary Gradle plugins that need to be resolved
     id("newrelic") version "<AGENT_VERSION>" apply false
   }

   コピー

3. プラグインをアプリレベルのビルドファイルに適用します

   plugins {
       id("com.android.application")
       id("org.jetbrains.kotlin.android")
       id("newrelic")
   }

   コピー

上記のスニペットでは、 <AGENT_VERSION>はエージェントのバージョン番号を表しています。 設定には最新のエージェントを使用することを強くお勧めします。

Android 4.x：Multidexサポート

Android 5.0（APIレベル21）より前のAndroidバージョン用のモバイルモニタリングでは、アプリコードの実行にDalvikランタイムを使用します。デフォルトで、DalvikはアプリをAPK当たり単一のclasses.dexバイトコードファイルに制限します。この制限を回避するには、Multidexサポートを有効化する必要があります。その後、アプリのプライマリDEXファイルの一部となるMultidexサポートライブラリを使用できます。ライブラリは、追加のDEXファイルとそれに含まれるコードへのアクセスを管理します。

次のステップ

Androidエージェントが正常にインストールされました！次の手順にはいくつかのオプションがあります。

• New Relic Gradleプラグインを使用して、Gradleビルド中のエージェントの動作を設定します
• AndroidエージェントSDKをアップグレードして、Androidエージェントを最新の状態に保ちます
• Androidのインストレーションで問題が発生しましたか？トラブルシューティングの手順に従ってください