Firebase Test Lab インストゥルメンテーションテストのスクリーンショットを作成する

Firebase Test Lab には、インストゥルメンテーションテスト（Espresso テストフレームワークを使用して記述したテストなど）の実行時にスクリーンショットを作成するためのライブラリが含まれています。テストにこの機能を追加するには、cloudtestingscreenshotter_lib.aar ライブラリを使用します。

スクリーンショットを作成する機能は、NotePad サンプルアプリのテスト APK（app-debug-test-unaligned.apk）にすでに組み込まれており、Robo テストの実行時にもスクリーンショットがキャプチャされます。アプリにスクリーンショットライブラリを追加する方法と、テストからこのライブラリを呼び出す手順を以下に示します。

テストが完了すると、Android Studio または Firebase コンソールでスクリーンショットを確認できます。

プロジェクトにスクリーンショットライブラリを追加する

Android Studio で [Project] ビューを開いてプロジェクト名を右クリックし、[New] > [Directory] をクリックします。
[New Directory] ダイアログで「aars」と入力します。これで、テストプロジェクトのルートに（app フォルダのピアディレクトリとして）aars ディレクトリが作成されます。
cloudtestingscreenshotter_lib.aar をコピーして、aars フォルダに貼り付けます。
テストプロジェクトのルートで build.gradle を開き、このファイル内のすべての repositories セクションに aars フォルダへの参照を追加します。各セクションは以下の例のようになります。
```
repositories {
    jcenter()
    flatDir {
        dirs '../aars'
    }
}
...
```
モジュールの最上位のディレクトリ（NotePad サンプルアプリの場合は app ディレクトリ）で、build.gradle ファイルを開き、最上位の dependencies セクションに cloudtestingscreenshotter_lib.aar への依存関係を追加します。以下に例を示します。
```
dependencies {
    // Cloud testing
    androidTestCompile (name:'cloudtestingscreenshotter_lib', ext:'aar')
    // Other dependencies go here
    }
```
AndroidManifest.xml を開き、<manifest> 要素と </manifest> 要素の間に以下の行を追加します。

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

テストのスクリーンショットを作成する

テスト中にスクリーンショットを作成するタイミングで、cloudtestingscreenshotter_lib ライブラリから ScreenShotter.takeScreenshot メソッドを呼び出します。ここで最初の引数は、スクリーンショットを識別するラベルです（以下の例では main_screen_2 が使用されます）。

Java
Android

ScreenShotter.takeScreenshot("main_screen_2", this /* activity */);MainActivity.java

Kotlin
Android

ScreenShotter.takeScreenshot("main_screen_2", this /* activity */)MainActivity.kt

スクリーンショットを表示する

テストが完了したら、テスト結果ツリーで要素を選択し、[View Screenshots] スクリーンショットを表示するオプションをクリックすることによって、テスト中に作成したスクリーンショットを比較できます。

スクリーンショット比較画面

次のように、さまざまな構成からスクリーンショットを選択して比較できます。

タスク	アクション
テスト実行の切り替え	左上のプルダウンメニューを使用
テスト実行内のスクリーンショットの切り替え	右上の矢印を使用
現在のビューに別のスクリーンショット比較パネルを追加	[Compare] をクリック
別のテストディメンション（デバイスタイプ、画面の向き、言語 / 地域など）を選択	スクリーンショット下部のリストから新しいディメンションメンバーを選択