AndroidアプリをGradleおよびAndroid Studioとともにインストール

GradleまたはAndroid Studioを使用する場合は、次の手順に従ってNew Relicのモバイルモニタリングを初めてインストールします。モバイルモニタリング用にAndroidエージェントSDKを既にインストールしている場合は、GradleとAndroid Studioとともに最新バージョンにアップグレードする前の手順に従ってください。

Androidアプリをインストールする

モバイルモニタリングのインストレーションプロセスの一環として、New Relicはアプリケーショントークンを自動生成します。これはNew Relic でモニタリングする各モバイルアプリを認証するための40文字の16進数の文字列です。

one.newrelic.com > Mobileに移動します。
該当する場合：Mobile アプリインデックスから、Add a new appを選択します。
始めにページから、モバイルモニタリング用のプラットフォームとしてAndroidを選択します。
ご使用のモバイルアプリに意味のある名前を付けて、Continueを選択します。

GradleとAndroid Studioを使用したモバイルモニタリングの設定手順を続けます。

または

新しいモバイルアプリの設定プロセスを後で完了するには：one.newrelic.com > Mobileに移動してから、モバイルアプリ名の隣にあるSee instructionsを選択します。
既存のAndroidインストールをアップグレードするには：one.newrelic.com > Mobile >（アプリを選択）> Settings > Installationの順に移動します。

GradleおよびAndroid Studioを使用して設定

GradleとAndroid Studioを使用したAndroidアプリの設定手順は、New RelicのGet startedページにも掲載されています。

Gradle & Android StudioタブにあるNew Relicのモバイルモニタリングコードをbuild.gradleファイルにマージします。
この例では、AGENT_VERSIONがエージェントのバージョン番号を表しています。エージェントリリースノートを参照し、最新版を使用してください。
buildscript { repositories { mavenCentral() } dependencies { classpath "com.newrelic.agent.android:agent-gradle-plugin:AGENT_VERSION" } }
この例では、AGENT_VERSIONがエージェントのバージョン番号を表しています。エージェントリリースノートを参照し、最新版を使用してください。
repositories { mavenCentral() } apply plugin: 'android' apply plugin: 'newrelic' dependencies { implementation 'com.newrelic.agent.android:android-agent:AGENT_VERSION' }
ProGuardまたはDexGuard：プロジェクトのルートディレクトリ (projectname/app) に、以下の行を含むnewrelic.propertiesファイルを追加します。
```
com.newrelic.application_token=GENERATED_TOKEN
```
New RelicでProGuardまたはDexGuardを使用するために必要な追加の設定手順に従います。
アプリの権限を設定する：AndroidManifest.xmlファイルに以下の行を追加することで、AndroidアプリがINTERNETおよびACCESS_NETWORK_STATE許可を要求するようにします。
```
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```
New Relicのモバイルモニタリングエージェントを起動するには：デフォルトアクティビティ（マニフェストで定義）で、NewRelicクラスをインポートします。
```
import com.newrelic.agent.android.NewRelic;
```
重要
想定外の動作や不安定な動作が生じる可能性があるため、他のクラスでのモバイルモニタリングエージェントの起動はサポートされていません。
モバイルモニタリングを初期化するには：onCreate()メソッドで、次の呼び出しを追加します。
```
NewRelic.withApplicationToken("GENERATED_TOKEN").start(this.getApplication());
```
オプション：ログ記録レベルを変更します。
アプリケーションをビルドして実行するには：プロジェクトをクリーンにし、エミュレーターまたはデバイスでアプリを実行し、トラフィックを生成します。
数分待ち、概要ページからAndroidアプリのデータを表示します。one.newrelic.com > Mobile >（アプリを選択）の順に移動します。

Androidのインストレーションに問題がある場合や、モバイルモニタリングUIにデータが表示されない場合は、トラブルシューティング手順に従ってください。

Androidインストレーションの更新

Androidエージェントを最新に保つため、New RelicのAndroidエージェントSDKをアップグレードする手順に従ってください。モバイルアプリに最新のAndroidバージョンをインストールするには：one.newrelic.com > Mobile >（アプリを選択）> Settings > Installationの順に移動します。

Android 4.x：Multidexサポート

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

Multidexアプリケーション用に各DEXファイルを構築する際、ビルドツールはアプリケーションが正常に起動できるよう、プライマリDEXファイルにどのクラスが必要か決めるため複雑な意思決定を行います。起動中に必要となるクラスがプライマリDEXファイルに用意されてない場合、アプリケーションはjava.lang.NoClassDefFoundErrorエラーでクラッシュします。

java.lang.NoClassDefFoundErrorエラーが表示された場合は、プライマリDEXファイルで必要に応じてこれらの追加クラスを手動で指定する必要があります。

プロジェクトの/appフォルダー内にproguard.multidex.configファイルを作成します。パッケージ名が反映するように、mypackageを更新します。
```
####################
# keep class names #
####################

#Keep New Relic in the main dex
-keep class com.newrelic.** { *; }
-keep class com.mypackage.activities.** { *; }
```

アプリケーションレベルのbuild.gradleファイルに、以下のコードをマージします。

android { 
    defaultConfig{
        …
        multiDexKeepProguard file("proguard.multidex.config")
    }
}

詳細については、プライマリDEXファイルに必要なクラス宣言に関する、Android開発者用ドキュメントを参照してください。

New Relic Gradleプラグインの設定

Gradle構築の間のモバイルモニタリングエージェントプラグインの動作の設定方法の詳細は、New Relic Gradleプラグイン拡張ガイドを参照してください。