BrowserstackのApp Automateによるアプリのテスト
BrowserStackのApp Automate Espressoを使用すると、さまざまなAndroidのモバイルおよびタブレットデバイスでネイティブアプリやハイブリッドアプリをテストできます。専用のインテグレーションを利用することで、BitriseのビルドでApp Automateを使用できます。
App Automate Espressoの設定Click to copy link
Browserstackインテグレーションを設定するには、次の手順に従います。
-
BrowserstackのユーザーネームとAccess keyを用意します。
-
BitriseでWorkflow Editorを開き、Android Build for UI testing StepをWorkflowに追加します。
-
Project locationインプットがAndroidアプリのルートディレクトリを指していることを確認します。
-
ビルドしたいモジュールとバリアントをModuleインプットとVariantインプットで設定します。
Gradle 引数必要に応じて、Additional Gradle Argumentsインプットでビルドタスクにadditional Gradle argumentsを渡すことができます。
-
BrowserStack App Automate - Espresso StepをWorkflowに追加します。これはAndroid Build for UI testing Stepに従う必要があります。
-
必要なStep inputsを設定します。
Input group Input name Input value Authentication BrowserStack username 文字列形式のBrowserStackのユーザーネーム。 BrowserStack access key BrowserStackのAccess Key。 App & Test Suite Android app under test テスト用APKファイルへのパス。デフォルトでは変更する必要はありません。Android Build for UI testing Stepがこのパスを環境変数としてエクスポートし、それがdefault valueとして使用されます。 Espresso test suite テストスイートファイルへのパス。デフォルトでは変更する必要はありません。Android Build for UI testing Stepがこのパスを環境変数としてエクスポートし、それがdefault valueとして使用されます。 Devices Devices 1つ以上のデバイスとOSの組み合わせを改行区切りで設定します。可能な組み合わせはこちらのリストで確認できます。 -
必要に応じて、高度な設定オプションを設定します。
App Automate Espressoの高度な設定Click to copy link
BrowserStack App Automate - Espresso Stepでは、高度な設定オプションを利用できます。これらのオプションはすべてTest configurationインプットグループで使用できます。
| Input name | Description | Values |
|---|---|---|
| Filter tests | サポートされているフィルタリング戦略に従って、クラス名またはテスト名をカンマ区切りのリストで指定します。フィルタリングされたテストケースのみが実行されます。 | フィルタのキーと値のペア。指定できるフィルタにはclass、package、annotation、sizeがあります。例: class com.foo.AddToCartClass,class com.foo.CheckoutClass |
| Project name | テストに対してproject nameを指定します。複数のEspressoテストの実行を1つのプロジェクトの下に論理的にグループ化できます。これにより、Browserstack上のApp Automateダッシュボードで関連するすべてのテスト実行に簡単にアクセスできます。 | 文字列。使用できる文字は、英字(A-Z、a-z)、数字(0-9)、ピリオド(.)、コロン(:)、ハイフン(-)、角括弧([])、スラッシュ(/)、アットマーク(@)、アンパサンド(&)、シングルクォート(')、アンダースコア(_)です。それ以外の文字は無視されます。 |
| Test sharding | 順番に実行する代わりにテストケースを異なるグループに分割するため、test shardingを有効にします。 | シャード数を指定し、その動作を設定するためにキーと値のペアを設定します。シャーディング戦略には3種類あり、それぞれ異なる設定が必要です。 - Auto戦略: {"numberOfShards": 2}, "devices": ["Google Pixel 3-9.0"] - Package戦略: {"numberOfShards": 2, "mapping": [{"name": "Shard 1", "strategy": "package", "values": ["com.foo.login", "com.foo.logout"]}, {"name": "Shard 2", "strategy": "package", "values": ["com.foo.dashboard"]}]} - Class戦略: {"numberOfShards": 2, "mapping": [{"name": "Shard 1", "strategy": "class", "values": ["com.foo.login.user", "com.foo.login.admin"]}, {"name": "Shard 2", "strategy": "class", "values": ["com.foo.logout.user"]}]} |
| Single runner invocation | ビルド全体の時間を短縮するため、すべてのテストを単一のインストルメンテーションプロセスで実行するsingle runner invocationを有効にします。 | trueまたはfalse default valueはfalseです。 |
| Local testing | ローカル/プライベートサーバーでホストされているアプリデータを取得するため、Local testingを有効にします。 | trueまたはfalse false default valueはfalseです。 |
| Mock server | モックWebサーバーは、実際のリモートサーバーの動作を模倣します。これにより、リモートサーバーに依存したり変更を加えたりすることなく、さまざまなシナリオを簡単にテストできます。Local testingはモックサーバーでは機能しません。 | trueまたはfalse default valueはfalseです。 |
| Clear app data | 各テスト実行後にアプリのストレージをクリアし、各テストケースがクリーンなアプリの状態から開始されるようにします。 | trueまたはfalse default valueはfalseです。 |
| Notify project status | 特定のプロジェクト配下のすべてのビルドが完了したときにBrowserStackが呼び出すコールバックURLです。5分間新しいビルドがトリガーされず、既存のすべてのビルドが完了すると、コールバックを受け取ります。Project nameも設定する必要があります。 | URL。 |
| Test capabilities | BrowserStackが提供する追加のcapabilitiesを、改行区切りのキーと値のペアで指定します(例: coverage=true)。詳細はこちら。 | キーと値のペアを1行ずつ指定します。 |
| Build Status | BrowserStackが実行を完了しテスト結果を取得するまで待機します。 | trueまたはfalse default valueはtrueです。 |
App Automate EspressoのロギングオプションClick to copy link
BrowserStack App Automate - Espresso Stepでは、ロギングおよび診断オプションも提供されており、Debug logsインプットグループで使用できます。
| Input name | Description | Values |
|---|---|---|
| Instrumentation logs | Espressoテストの実行に関する包括的な記録で、テスト内で実行されたすべてのステップを特定するのに役立ちます。 | trueまたはfalse default valueはtrueです。 |
| Network Logs | ネットワークトラフィック、レイテンシー、HTTPのリクエストとレスポンスをHAR(HTTP Archive)形式でキャプチャします。 | trueまたはfalse default valueはfalseです。 |
| Android logcat logs | Androidのlogcatによって生成される、アプリケーション固有のシステムログで、テストのクラッシュをデバッグするのに役立ちます。 | trueまたはfalse default valueはfalseです。 |
| Capture Screenshots | スクリーンショットをキャプチャし、テスト内で失敗が発生した正確なステップを特定しやすくします。 | trueまたはfalse default valueはfalseです。 |
| Video recording | テスト実行全体を確認し、失敗したテストをデバッグするのに役立つよう、テスト実行のビデオを記録します。 | trueまたはfalse default valueはtrueです。 |