メインコンテンツまでスキップ

Androidのデバイステスト

BitriseのAndroid仮想デバイステストソリューションを使用すると、独自のデバイスをセットアップして登録することなく、エミュレーターでUIテストを実行できます。

制限事項

仮想デバイステストの最大実行時間は60分です。Test timeout入力でこの値を設定できます。デフォルトは15分です。

1つのビルドには、Virtual Device Testing Stepを1つだけ含めることができ、これはinstrumentation、robo、またはgameloopのいずれか1種類のテストを実行します。

このデバイステストソリューションはFirebase Test Labをベースにしています。生成されたログ、動画、スクリーンショットはBitriseで確認できます。

テストの実行Click to copy link​

Bitriseでは、3種類のテストタイプから選択できます。

  • robo(Bitriseのデフォルトのテストタイプ)。
  • instrumentation。
  • gameloop。

これらのテストタイプの違いについて詳しく知りたい場合は、Firebaseのドキュメントを参照してください。

roboテストとinstrumentationテストではWorkflowの設定方法が少し異なるため、それぞれ別々に見ていきましょう。

roboテストの実行Click to copy link​

  1. 使用するWorkflowをWorkflow Editorで開きます。

  2. APKをエクスポートするために、Android Build StepをWorkflowに追加します。

    StepはAPKのパスをEnv Varに保存します。このEnv Varは後で必要になります。

  3. DebugタスクをVariant Step入力フィールドに追加します。

  4. Virtual Device Testing for Android StepをAndroid Build Stepの後に追加します。

  5. App path入力フィールドを設定します。

  6. Test type入力をroboに設定します。

  7. Test devices入力フィールドにテストデバイスの種類を追加します。

    デフォルト以外のデバイスを選択する場合、入力はdeviceID、version、language、orientationを,で区切った形式にする必要があります。使用可能なデバイスの一覧はこちらで確認できます。

  8. 必要に応じて、テストの実行が自動的にキャンセルされるまでの時間を制御するTest timeout入力を設定します。デフォルトは15分、最大は60分です。

  9. ビルドを開始し、テスト結果を確認します。

roboテストを成功させるためのRobo directivesによるユーザー入力の設定Click to copy link​

アプリでroboテストを成功させるために特定のユーザー操作が必要な場合は、Robo directives入力フィールドを使用して必要な入力を設定できます。たとえば、アプリの特定のUI要素は、ログインに必要なユーザー入力(ユーザー名とメールアドレス)が入力されている場合にのみ、roboテストでアクセスできます。

  1. Workflow内のVirtual Device Testing for Android Stepをクリックします。

  2. Robo Testセクションをクリックします。

  3. Robo directives入力フィールドを見つけて、必要なユーザー入力ディレクティブを設定します。

    • provide aカンマ区切りのキーと値のペアのリストです。キーはAndroidリソース名(対象となるUI要素のもの)、値はテキスト文字列です。EditTextフィールドはサポートされていますが、WebView UI要素内のテキストフィールドはサポートされていません。たとえば、カスタムログインには次のパラメーターを使用できます。

      username_resource,username,ENTER_TEXT
      password_resource,password,ENTER_TEXT
      loginbtn_resource,,SINGLE_CLICK
    • 1行につき1つのディレクティブを記述し、パラメーターは,(カンマ)で区切ります。例:ResourceName,InputText,ActionType。

    Device_testing_for_Android.png

指定した入力に基づいて、(特定のユーザー入力でのみアクセスできるページであっても)roboテストを正常に実行し、テスト結果をTestsタブ(Buildページ)で確認できます。テスト結果には、たとえば次のものがあります。

  • スクリーンショット。

    録画された動画。

    ログ。

    ファイル。

以下は、成功したroboテストのスクリーンショットです。Robo directivesで事前定義されたディレクティブによってメールアドレスとパスワードのフィールドが最初に入力され、roboテストがMy applicationまで到達しています。

Device_testing_for_Android.jpg

instrumentationテストの実行Click to copy link​

  1. 使用するWorkflowをWorkflow Editorで開きます。

  2. Android Build(UIテスト用)StepをWorkflowに追加します。

  3. APKとTest APKをエクスポートするには、Android Build(UIテスト用)Stepで次の入力フィールドを設定する必要があります。

    • Project Location:Androidプロジェクトのルートディレクトリ。
    • Module:ビルドするモジュールを設定します。
    • Variant:ビルドするバリアントを設定します(通常はDebug)。

    Device_testing_for_Android.png

    Stepの出力は、BITRISE_APK_PATH(フィルタリング後に生成されたAPKのパス)とBITRISE_TEST_APK_PATH(フィルタリング後に生成されたテストAPKのパス)になります。

  4. Virtual Device Testing for Android StepをAndroid Build(UIテスト用)Stepの直後に追加します。

  5. Test type入力をinstrumentationに設定します。

    Android Build for UI Testing StepはAPKとTest APKをエクスポートし、それらのパスはApp pathおよびTest APK path入力フィールド(Virtual Device Testing for Android Step)に自動的に設定されます。

  6. Test devices入力フィールドにテストデバイスの種類を追加します。

    デフォルト以外のデバイスを選択する場合、入力はdevice ID、version、language、orientationを,で区切った形式にする必要があります。

    Device_testing_for_Android.png

  7. 必要に応じて、テストの実行が自動的にキャンセルされるまでの時間を制御するTest timeout入力を設定します。デフォルトは15分、最大は60分です。

  8. ビルドを開始し、テスト結果を確認します。