アプリのテスト

Android Studio はテストがシンプルになるように設計されています。ローカル JVM で実行される JUnit テストや端末で実行されるインストルメント化されたテストをわずか数クリックでセットアップすることができます。

ローカルユニットテストで Android API の呼び出しをテストするための Mockito、インストルメント化されたテストでユーザーインタラクションを行うための Espresso や UI Automator などのテストフレームワークを統合することにより、テスト機能を拡張することもできます。

Espresso Test Recorder を使用すると、Espresso テストを自動的に生成することができます。

このページでは、アプリに新しいテストを追加して、Android Studio から実行する方法に関する基本的な情報を提供します。

テストの作成方法に関する詳細なガイドは、テストの概要をご覧ください。

テストのタイプと場所

テストコードの場所は、作成するテストのタイプによって異なります。 Android Studio では、次の 2 つのタイプのテストのために、ソースコードディレクトリ（ソースセット）を提供しています。

ローカルユニットテスト

module-name/src/test/java/ にあります。

これらのテストは、マシンのローカル Java 仮想マシン（JVM）上で実行されます。テストに Android フレームワークの依存関係がない場合、または Android フレームワークの依存関係をモックで代用できる場合は、これらのテストを使用して実行時間を最小限に抑えることができます。

実行時に、これらのテストは、すべての final 修飾子が削除されている修正版の android.jar に対して実施されます。そのため、Mockito などの一般的なモックライブラリを使用できます。

インストルメント化されたテスト

module-name/src/androidTest/java/ にあります。

これらのテストは、ハードウェア端末またはエミュレータで実行されます。これらのテストは Instrumentation API にアクセスして、テストしているアプリの Context などの情報へのアクセスを可能にし、テストコードからテスト中のアプリを制御できるようにします。ユーザーインタラクションを自動化するための統合および機能 UI のテストを作成する場合、またはモックオブジェクトでは代用できない Android 依存関係がテストにある場合は、これらのテストを使用します。

インストルメント化されたテストは（アプリの APK とは別の）APKに組み込まれるため、テスト用の AndroidManifest.xml ファイルが含まれている必要があります。ただし、Gradle はビルド時にこのファイルを自動的に生成するため、このファイルはプロジェクトのソースセットに表示されません。 `minSdkVersion` の別の値を指定したり、テスト用の実行リスナーを登録したりするために、必要に応じて、独自のマニフェストファイルを追加することができます。アプリをビルドするときに、Gradle は複数のマニフェストファイルを 1 つのマニフェストに統合します。

Gradle のビルドは、プロジェクトのアプリソースセットの場合と同じように、これらのテストソースセットを解釈します。そのため、ビルドバリアントに基づいてテストを作成することができます。

新しいプロジェクトを作成すると、またはアプリのモジュールを追加すると、Android Studio は、上記のテストソースセットを作成し、各ソースセットにサンプルテストファイルを含めます。

図 1 に示されているように、これらのテストソースセットは [Project] ウィンドウに表示されます。

図 1. プロジェクトの（1）インストルメント化されたテストと（2）ローカル JVM テストは、[Project] ビュー（左）または [Android] ビュー（右）に表示されます。

新しいテストの追加

ローカルユニットテストまたはインストルメント化されたテストを作成する場合、次の手順を実行して、特定のクラスまたはメッソッド用の新しいテストを作成することができます。

テストするコードが含まれている Java ファイルを開きます。
テストするクラスまたはメソッドをクリックしてから、Ctrl+Shift+T（⇧⌘T）を押します。
表示されたメニューで、[Create New Test] をクリックします。
[Create Test] ダイアログで、フィールドを編集し、生成するメソッドを選択してから、[OK] をクリックします。
[Choose Destination Directory] ダイアログで、作成するテストのタイプに対応するソースセットをクリックします。つまり、インストルメント化されたテストの場合は [androidTest] を、ローカルユニットテストの場合は [test] をクリックします。

[OK] をクリックします。

または、次の手順を実行して、適切なテストソースセットに汎用 Java ファイルを作成できます。

左側の [Project] ウィンドウで、プルダウンメニューをクリックして、[Project] ビューを選択します。
適切なモジュールフォルダとネストされた [src] フォルダを展開します。ローカルユニットテストを追加するには、[test] フォルダとネストされた [java] フォルダを展開します。インストルメント化されたテストを追加するには、[androidTest] フォルダとネストされた [java] フォルダを展開します。
Java パッケージディレクトリを右クリックして、[New] > [Java Class] を選択します。
ファイルに名前を付けてから、[OK] をクリックします。

また、アプリモジュールの build.gradle ファイルでテストライブラリの依存関係を指定する必要があります。

dependencies {
    // Required for local unit tests (JUnit 4 framework)
    testCompile 'junit:junit:4.12'

    // Required for instrumented tests
    androidTestCompile 'com.android.support:support-annotations:24.0.0'
    androidTestCompile 'com.android.support.test:runner:0.5'
}

オプションのその他のライブラリ依存関係と、テストを作成する方法の詳細については、ローカルユニットテストのビルドとインストルメント化されたテストのビルドをご覧ください。

ビルドバリアント用のインストルメント化されたテストの作成

一意のソースセットを備えたビルドバリアントがプロジェクトに含まれる場合は、対応するインストルメント化されたテストのソースセットが必要です。

ビルドバリアントに対応するインストルメント化されたテストのソースセットを作成すると、テストコードを整理された状態に保ち、特定のビルドバリアントのみに適用されるテストを実行することができます。

ビルドバリアントのテストソースセットを追加するには、次の手順を実行します。

左側の [Project] ウィンドウで、プルダウンメニューをクリックして、[Project] ビューを選択します。
適切なモジュールフォルダ内で、[src] フォルダを右クリックして、[New] > [Directory] をクリックします。
ディレクトリ名として "androidTestVariantName" と入力します。たとえば、"MyFlavor" というビルドバリアントがある場合、ディレクトリ名は "androidTestMyFlavor" にする必要があります。

[OK] をクリックします。 1. 新しいディレクトリを右クリックして、[New] > [Directory] をクリックします。 1. ディレクトリ名として "java" と入力して、[OK] をクリックします。

上記の手順で新しいテストを追加すると、この新しいソースセットにテストを追加することができます。 [Choose Destination Directory] ダイアログが表示されたら、バリアントの新しいテストソースセットを選択します。

src/androidTest/ ソースセットのインストルメント化されたテストは、すべてのビルドバリアントによって共有されます。アプリの "MyFlavor" バリアントのテスト APK をビルドすると、Gradle は src/androidTest/ と src/androidTestMyFlavor/ の両方のソースセットを組み合わせます。

たとえば、次の表は、アプリのコードのソースセットに対応するソースセット内にインストルメンテーションテストファイルを配置する方法を示しています。

アプリクラスへのパス	一致するインストルメンテーションテストクラスへのパス
`src/main/java/Foo.java`	`src/androidTest/java/AndroidFooTest.java`
`src/myFlavor/java/Foo.java`	`src/androidTestMyFlavor/java/AndroidFooTest.java`

アプリソースセットの場合と同じように、Gradle のビルドは、異なるテストソースセットのファイルを統合およびオーバーライドします。この場合、"androidTestMyFlavor" ソースセットの AndroidFooTest.java ファイルにより、"androidTest" ソースセットのバージョンがオーバーライドされます。

ソースセットが統合される方法の詳細については、ビルドの設定をご覧ください。

アプリとテストソースセットに対してビルドバリアントを使用すべきもう 1 つの理由は、モック依存関係を利用して閉じられた環境でのテストを作成するためです。つまり、依存関係のフェイク実装（通常は不安定なネットワークリクエストや端末センサーデータ）が含まれるアプリのプロダクトフレーバーを作成してから、対応するモックテストソースセットを追加することができます。

詳細については、閉じた環境でテストを行うためにプロダクトフレーバーを活用することに関するブログ投稿をご覧ください。

テストの実行

テストを実行するには、次の手順を実行します。

ツールバーの [**Sync Project **] をクリックして、プロジェクトと Gradle を同期する必要があります。
次のいずれかの方法でテストを実行します。
- [Project] ウィンドウで、テストを右クリックして、[Run] をクリックします。
- コードエディタで、テストファイルのクラスまたはメソッドを右クリックして、[Run] をクリックし、クラスのすべてのメソッドをテストします。
- すべてのテストを実行するには、テストディレクトリを右クリックして、[Run tests] をクリックします。

デフォルトでは、テストは、Android Studio のデフォルトの実行構成を使用して実行されます。インストルメンテーションランナーやデプロイのオプションなど、いくつかの実行構成を変更する場合は、（[Run] > [Edit Configurations] をクリックして）[Run/Debug Configurations] ダイアログで実行構成を編集することができます。

テストするビルドタイプの変更

デフォルトでは、すべてのテストは、デバッグビルドタイプに対して実行されます。モジュールレベルの build.gradle ファイルの testBuildType プロパティを使用して、対象を別のビルドタイプに変更することができます。

たとえば、"staging" ビルドタイプに対してテストを実行する場合は、次のスニペットのようにファイルを編集します。

android {
    ...
    testBuildType "staging"
}