Androidアプリのインストゥルメンテッドテストの実行
インストルメンテッドテストは、実機かエミュレーターかを問わず、Androidデバイスで実行します。Bitriseでは、adbツールを使用してインストルメンテッドテストを実行できます。インストルメンテッドテストを実行するには、Workflow内に2つのStepsが必要です。
- Android Build for UI testingStepは、APKとテスト用APKの両方をビルドします。たとえば
MyappDebug.apkとMyAppDebugAndroidTest.apkです。Stepは、これらのAPKのパスを2つの出力Environment Variables(BITRISE_APK_PATHとBITRISE_TEST_APK_PATH)に保存します。これらのEnv Varsを使用して、同じWorkflow内の後続のStepsでAPKにアクセスできます。 - Android Instrumented TestStepは、前のStepでビルドされたAPKを使用してインストルメンテッドテストを実行します。
Androidでインストルメンテッドテストを実行するには:
- Workflow Editor
- Configuration YAML
-
Android Build for UI testingStepをWorkflowに追加します。
-
Project locationの入力がAndroidアプリのルートディレクトリを指していることを確認してください。
-
ビルドしたいモジュールとバリアントをModuleとVariantの入力に設定します。
利用可能なモジュールとバリアントは、Android StudioのProjectウィンドウで確認できます。

-
Optionsの入力グループでは、APK location patternの入力で生成されるAPKファイルの場所を設定できます。
この入力にはファイルパターンを値として指定します。default valueは
*/build/outputs/apk/*.apkです。 -
必要に応じて、Additional Gradle Argumentsの入力でビルドタスクにadditional Gradle argumentsを渡すこともできます。
-
Android Build for UI testingStepの後の任意の時点で、Android Instrumented TestStepをWorkflowに追加します。
-
Main APK pathとTest APK pathの入力が正しい場所を指していることを確認してください。
デフォルトでは、2つの入力の値はそれぞれBITRISE_APK_PATHとBITRISE_TEST_APK_PATHのEnvironment Variablesです。これらの変数はAndroid Build for UI testingStepによってエクスポートされます。そのため、ほとんどの場合、これらの入力の値を変更する必要はありません。

-
Test runner classの入力で、使用したいテストランナーを指定します。
デフォルトのランナーはAndroidJUnitRunnerクラスです。
-
必要に応じて、Additional testing optionsの入力を使用してテストランナーに追加のオプションを渡すことができます。
この入力を使用すると、
adbシェルのactivity managerツールにコマンドを発行できます。発行可能なコマンドの詳細については、adbの公式ドキュメントを参照してください。 -
テスト結果を表示するには、Deploy to Bitrise.io - Build Artifacts, Test Reports, and Pipeline intermediate filesStepをWorkflowに追加します。テスト結果のデプロイ。
-
android-build-for-ui-testingStepをWorkflowに追加します。steps:- git-clone: {}- android-build-for-ui-testing:inputs:- deploy-to-bitrise-io: {} -
project_locationの入力がAndroidアプリのルートディレクトリを指していることを確認してください。steps:- git-clone: {}- android-build-for-ui-testing:inputs:- project_location: $BITRISE_SOURCE_DIR- deploy-to-bitrise-io: {} -
ビルドしたいモジュールとバリアントを
moduleとvariantの入力に設定します。利用可能なモジュールとバリアントは、Android StudioのProjectウィンドウで確認できます。
steps:- git-clone: {}- android-build-for-ui-testing:inputs:- module: app- variant: debug- project_location: $BITRISE_SOURCE_DIR- deploy-to-bitrise-io: {} -
apk_path_patternの入力で、生成されるAPKファイルの場所を設定できます。この入力にはファイルパターンを値として指定します。default valueは
*/build/outputs/apk/*.apkです。steps:- git-clone: {}- android-build-for-ui-testing:inputs:- arguments: flag- module: app- variant: debug- apk_path_pattern: '*/build/outputs/apk/*.apk'- project_location: $BITRISE_SOURCE_DIR- deploy-to-bitrise-io: {} -
必要に応じて、
argumentsの入力でビルドタスクにadditional Gradle argumentsを渡すこともできます。steps:- git-clone: {}- android-build-for-ui-testing:inputs:- arguments: --task- module: app- variant: debug- apk_path_pattern: '*/build/outputs/apk/*.apk'- project_location: $BITRISE_SOURCE_DIR- deploy-to-bitrise-io: {} -
android-build-for-ui-testingStepの後の任意の時点で、android-instrumented-testStepをWorkflowに追加します。steps:- git-clone: {}- android-build-for-ui-testing:inputs:- arguments: flag- module: app- variant: debug- apk_path_pattern: '*/build/outputs/apk/*.apk'- cache_level: all- project_location: $BITRISE_SOURCE_DIR- android-instrumented-test:inputs:- deploy-to-bitrise-io: {} -
main_apk_pathとtest_apk_pathの入力が正しい場所を指していることを確認してください。デフォルトでは、2つの入力の値はそれぞれBITRISE_APK_PATHとBITRISE_TEST_APK_PATHのEnvironment Variablesです。これらの変数は
android-build-for-ui-testingStepによってエクスポートされます。そのため、ほとんどの場合、これらの入力の値を設定する必要はありません。steps:- git-clone: {}- android-build-for-ui-testing:inputs:- arguments: flag- module: app- variant: debug- apk_path_pattern: '*/build/outputs/apk/*.apk'- cache_level: all- project_location: $BITRISE_SOURCE_DIR- android-instrumented-test:inputs:- main_apk_path: $BITRISE_APK_PATH- test_apk_path: $BITRISE_TEST_APK_PATH- deploy-to-bitrise-io: {} -
test_runner_classの入力で、使用したいテストランナーを指定します。デフォルトのランナーはAndroidJUnitRunnerクラスです。
steps:- git-clone: {}- android-build-for-ui-testing:inputs:- arguments: flag- module: app- variant: debug- apk_path_pattern: '*/build/outputs/apk/*.apk'- cache_level: all- project_location: $BITRISE_SOURCE_DIR- android-instrumented-test:inputs:- test_runner_class: androidx.test.runner.AndroidJUnitRunner- main_apk_path: $BITRISE_APK_PATH- test_apk_path: $BITRISE_TEST_APK_PATH- deploy-to-bitrise-io: {} -
必要に応じて、
additional_testing_optionsの入力を使用してテストランナーに追加のオプションを渡すことができます。この入力を使用すると、
adbシェルのactivity managerツールにコマンドを発行できます。発行可能なコマンドの詳細については、adbの公式ドキュメントを参照してください。たとえば、値KEY1 true KEY2 falseはadbにadb shell am instrument -e "KEY1" "true" "KEY2" "false" [...]として渡されます。steps:- git-clone: {}- android-build-for-ui-testing:inputs:- arguments: flag- module: app- variant: debug- apk_path_pattern: '*/build/outputs/apk/*.apk'- cache_level: all- project_location: $BITRISE_SOURCE_DIR- android-instrumented-test:inputs:- test_runner_class: androidx.test.runner.AndroidJUnitRunner- additional_testing_options: KEY1 true KEY2 false- main_apk_path: $BITRISE_APK_PATH- test_apk_path: $BITRISE_TEST_APK_PATH- deploy-to-bitrise-io: {} -
テスト結果を表示するには、Deploy to Bitrise.io - Build Artifacts, Test Reports, and Pipeline intermediate filesStepをWorkflowに追加します。テスト結果のデプロイ。