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
- Workflow Editor
- Configuration YAML
-
使用するWorkflowをWorkflow Editorで開きます。
-
APKをエクスポートするために、Android Build StepをWorkflowに追加します。
StepはAPKのパスをEnv Varに保存します。このEnv Varは後で必要になります。
-
DebugタスクをVariant Step入力フィールドに追加します。 -
Virtual Device Testing for Android StepをAndroid Build Stepの後に追加します。
-
App path入力フィールドを設定します。 -
Test type入力をroboに設定します。
-
Test devices入力フィールドにテストデバイスの種類を追加します。
デフォルト以外のデバイスを選択する場合、入力は
deviceID、version、language、orientationを,で区切った形式にする必要があります。使用可能なデバイスの一覧はこちらで確認できます。 -
必要に応じて、テストの実行が自動的にキャンセルされるまでの時間を制御するTest timeout入力を設定します。デフォルトは15分、最大は60分です。
-
ビルドを開始し、テスト結果を確認します。
-
Configuration YAMLファイルで、使用するWorkflowを見つけるか、新規作成します。
-
android-buildStepをWorkflowに追加します。StepはAPKのパスをEnv Varに保存します。このEnv Varは後で必要になります。
my-workflow:steps:- git-clone: {}- android-build:inputs: -
variant入力をDebugに設定します。my-workflow:steps:- git-clone: {}- android-build:inputs:- variant: Debug -
virtual-device-testing-for-androidStepを追加します。my-workflow:steps:- git-clone: {}- android-build:inputs:- variant: Debug- virtual-device-testing-for-android:inputs: -
app_path入力フィールドを設定します。デフォルトでは、値は$BITRISE_APK_PATH Env Varです。このEnv Varはandroid-buildStepによってエクスポートされます。my-workflow:steps:- git-clone: {}- android-build:inputs:- variant: Debug- virtual-device-testing-for-android:inputs:- app_path: $BITRISE_APK_PATH -
test_type入力をroboに設定します。my-workflow:steps:- git-clone: {}- android-build:inputs:- variant: Debug- virtual-device-testing-for-android:inputs:- test_type: robo- app_path: $BITRISE_APK_PATH -
test_devices入力フィールドにテストデバイスの種類を追加します。入力は
device ID、version、language、orientationを,で区切った形式にする必要があります。サポートされているモデルサポートされているデバイスモデルは、
gcloud firebase test android models list --filter=virtualgcloud firebase test android models list --filter=virtualコマンドをGoogle Cloud CLIで実行すると確認できます。my-workflow:steps:- git-clone: {}- android-build:inputs:- variant: Debug- virtual-device-testing-for-android:inputs:- test_type: robo- app_path: $BITRISE_APK_PATH- test_devices: 'MediumPhone.arm,33,en,portrait' -
必要に応じて、テストの実行が自動的にキャンセルされるまでの時間(秒単位)を制御する
test_timeout入力を設定します。デフォルトは900(15分)、最大は3600(60分)です。my-workflow:steps:- git-clone: {}- android-build:inputs:- variant: Debug- virtual-device-testing-for-android:inputs:- test_type: robo- app_path: $BITRISE_APK_PATH- test_devices: 'MediumPhone.arm,33,en,portrait'- test_timeout: '3600' -
ビルドを開始し、テスト結果を確認します。
roboテストを成功させるためのRobo directivesによるユーザー入力の設定Click to copy link
アプリでroboテストを成功させるために特定のユーザー操作が必要な場合は、Robo directives入力フィールドを使用して必要な入力を設定できます。たとえば、アプリの特定のUI要素は、ログインに必要なユーザー入力(ユーザー名とメールアドレス)が入力されている場合にのみ、roboテストでアクセスできます。
-
Workflow内のVirtual Device Testing for Android Stepをクリックします。
-
Robo Testセクションをクリックします。
-
Robo directives入力フィールドを見つけて、必要なユーザー入力ディレクティブを設定します。
-
provide aカンマ区切りのキーと値のペアのリストです。キーはAndroidリソース名(対象となるUI要素のもの)、値はテキスト文字列です。EditTextフィールドはサポートされていますが、WebView UI要素内のテキストフィールドはサポートされていません。たとえば、カスタムログインには次のパラメーターを使用できます。
username_resource,username,ENTER_TEXTpassword_resource,password,ENTER_TEXTloginbtn_resource,,SINGLE_CLICK -
1行につき1つのディレクティブを記述し、パラメーターは,(カンマ)で区切ります。例:ResourceName,InputText,ActionType。
-
指定した入力に基づいて、(特定のユーザー入力でのみアクセスできるページであっても)roboテストを正常に実行し、テスト結果をTestsタブ(Buildページ)で確認できます。テスト結果には、たとえば次のものがあります。
-
スクリーンショット。
録画された動画。
ログ。
ファイル。
以下は、成功したroboテストのスクリーンショットです。Robo directivesで事前定義されたディレクティブによってメールアドレスとパスワードのフィールドが最初に入力され、roboテストがMy applicationまで到達しています。

instrumentationテストの実行Click to copy link
- Workflow Editor
- Configuration YAML
-
使用するWorkflowをWorkflow Editorで開きます。
-
Android Build(UIテスト用)StepをWorkflowに追加します。
-
APKとTest APKをエクスポートするには、Android Build(UIテスト用)Stepで次の入力フィールドを設定する必要があります。
- Project Location:Androidプロジェクトのルートディレクトリ。
- Module:ビルドするモジュールを設定します。
- Variant:ビルドするバリアントを設定します(通常は
Debug)。

Stepの出力は、
BITRISE_APK_PATH(フィルタリング後に生成されたAPKのパス)とBITRISE_TEST_APK_PATH(フィルタリング後に生成されたテストAPKのパス)になります。 -
Virtual Device Testing for Android StepをAndroid Build(UIテスト用)Stepの直後に追加します。
-
Test type入力を
instrumentationに設定します。Android Build for UI Testing StepはAPKとTest APKをエクスポートし、それらのパスはApp pathおよびTest APK path入力フィールド(Virtual Device Testing for Android Step)に自動的に設定されます。
-
Test devices入力フィールドにテストデバイスの種類を追加します。
デフォルト以外のデバイスを選択する場合、入力は
device ID、version、language、orientationを,で区切った形式にする必要があります。
-
必要に応じて、テストの実行が自動的にキャンセルされるまでの時間を制御するTest timeout入力を設定します。デフォルトは15分、最大は60分です。
-
ビルドを開始し、テスト結果を確認します。
-
Configuration YAMLファイルで、使用するWorkflowを見つけるか、新規作成します。
-
android-build-for-ui-testingStepをWorkflowに追加します。my-workflow:steps:- git-clone: {}- android-build-for-ui-testing:inputs: -
APKとTest APKをエクスポートするには、Android Build(UIテスト用)Stepで次の入力フィールドを設定する必要があります。
project_location:Androidプロジェクトのルートディレクトリ。module:ビルドするモジュールを設定します。variant:ビルドするバリアントを設定します(通常はdebug)。
my-workflow:steps:- git-clone: {}- android-build-for-ui-testing:inputs:- module: module- variant: variant- project_location: $BITRISE_SOURCE_DIRStepの出力は、
BITRISE_APK_PATH(フィルタリング後に生成されたAPKのパス)とBITRISE_TEST_APK_PATH(フィルタリング後に生成されたテストAPKのパス)になります。 -
virtual-device-testing-for-androidStepをAndroid Build(UIテスト用)Stepの直後に追加します。my-workflow:steps:- git-clone@8: {}- android-build-for-ui-testing:inputs:- module: module- variant: variant- project_location: $BITRISE_SOURCE_DIR- virtual-device-testing-for-android:inputs: -
test_type入力をinstrumentationに設定します。android-build-for-ui-testingStepはAPKとTest APKをエクスポートし、それらのパスはapp_pathおよびtest_apk_path入力フィールド(virtual-device-testing-for-androidStep)に自動的に設定されます。my-workflow:steps:- git-clone: {}- android-build-for-ui-testing:inputs:- module: module- variant: variant- apk_path_pattern: '*/build/outputs/apk/*.apk'- arguments: arg- project_location: $BITRISE_SOURCE_DIR- virtual-device-testing-for-android:inputs:- test_type: instrumentation- app_path: $BITRISE_APK_PATH- test_apk_path: $BITRISE_TEST_APK_PATH -
test_devices入力フィールドにテストデバイスの種類を追加します。入力は
device ID、version、language、orientationを,で区切った形式にする必要があります。my-workflow:steps:- git-clone: {}- android-build-for-ui-testing:inputs:- module: module- variant: variant- apk_path_pattern: '*/build/outputs/apk/*.apk'- arguments: arg- project_location: $BITRISE_SOURCE_DIR- virtual-device-testing-for-android:inputs:- test_devices: 'MediumPhone.arm,33,en,portrait'- test_type: instrumentation- test_apk_path: $BITRISE_TEST_APK_PATH- app_path: $BITRISE_APK_PATH -
必要に応じて、テストの実行が自動的にキャンセルされるまでの時間(秒単位)を制御する
test_timeout入力を設定します。デフォルトは900(15分)、最大は3600(60分)です。my-workflow:steps:- git-clone: {}- android-build-for-ui-testing:inputs:- module: module- variant: variant- apk_path_pattern: '*/build/outputs/apk/*.apk'- arguments: arg- project_location: $BITRISE_SOURCE_DIR- virtual-device-testing-for-android:inputs:- test_devices: 'MediumPhone.arm,33,en,portrait'- test_type: instrumentation- test_apk_path: $BITRISE_TEST_APK_PATH- app_path: $BITRISE_APK_PATH- test_timeout: '3600' -
ビルドを開始し、テスト結果を確認します。