GradleおよびAndroid Studioを使用してAndroidアプリを設定する

Androidエージェントをインストールすると、モバイルアプリを設定することでパフォーマンスや安定性、ユーザーエンゲージメントを高めることができます。GradleとAndroid Studioを使用している場合は、以下の手順に従ってください。

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

GradleとAndroid StudioでAndroidアプリを設定するこれらの手順は、Androidのガイド付きUIインストールの「DSLコードを追加」手順にも表示されます。

プラグインが適用される前に、プロジェクトの最上位の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の場合：
a. プロジェクトのルートディレクトリ（/projectname/app）に、以下の行を含むnewrelic.propertiesファイルを追加します。
```
com.newrelic.application_token=GENERATED_TOKEN
```
b. Androidアプリ用の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" />
```
Androidエージェントを起動します。Default Activity（Manifestに定義されているもの）にNewRelicクラスをインポートします。
```
import com.newrelic.agent.android.NewRelic;
```
重要
想定外の動作や不安定な動作が生じる可能性があるため、他のクラスでのモバイルモニタリングエージェントの起動はサポートされていません。
モバイルモニタリングを初期化します。onCreate()メソッドに、次のコールを追加します。
```
NewRelic.withApplicationToken("GENERATED_TOKEN").start(this.getApplication());
```
（オプション）ログ記録レベルを変更します。
アプリケーションを構築して実行します。プロジェクトをクリーンにし、エミュレーターまたはデバイスでアプリケーションを実行しトラフィックを発生させます。
数分すると、概要ページからAndroidアプリケーションのデータを表示します。one.newrelic.com > Mobile >（アプリを選択）の順に移動します。

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

このドキュメントはインストールで役立ちましたか。

AndroidアプリのMultidexサポートを有効にして、64K参照制限を回避する方法をお読みください。

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構築の間のAndroidエージェントプラグインの動作の設定方法の詳細は、New Relic Gradleプラグイン拡張ガイドをご覧ください。