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

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

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

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

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

  1. Android Studio で [Project] ビューを開いてプロジェクト名を右クリックし、[New] > [Directory] をクリックします。
  2. [New Directory] ダイアログで「aars」と入力します。これで、テスト プロジェクトのルートに(app フォルダのピア ディレクトリとして)aars ディレクトリが作成されます。
  3. cloudtestingscreenshotter_lib.aar をコピーして、aars フォルダに貼り付けます。
  4. テスト プロジェクトのルートで build.gradle を開き、このファイル内のすべての repositories セクションに aars フォルダへの参照を追加します。各セクションは以下の例のようになります。

    repositories {
        jcenter()
        flatDir {
            dirs '../aars'
        }
    }
    ...

  5. モジュールの最上位のディレクトリ(NotePad サンプルアプリの場合は app ディレクトリ)で、build.gradle ファイルを開き、最上位dependencies セクションに cloudtestingscreenshotter_lib.aar への依存関係を追加します。以下に例を示します。

    dependencies {
        // Cloud testing
        androidTestCompile (name:'cloudtestingscreenshotter_lib', ext:'aar')
        // Other dependencies go here
        }
    

  6. 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 が使用されます)。

ScreenShotter.takeScreenshot("main_screen_2", getActivity());

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

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

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

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

タスク アクション
テスト実行の切り替え 左上のプルダウン メニューを使用

テストケース メニュー
テスト実行内のスクリーンショットの切り替え 右上の矢印を使用

スクリーンショットの切り替え
現在のビューに別のスクリーンショット比較パネルを追加 [Compare] をクリック

比較
別のテスト ディメンション(端末タイプ、画面の向き、言語/地域など)を選択 スクリーンショット下部のリストから新しいディメンション メンバーを選択

次のステップ

NotePad サンプルアプリをダウンロードする

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。