mabl CLIでは、モバイルテストに使用するモバイルビルドファイルをプログラムで管理でき、CI/CDとの統合も可能です。この記事では、新しいビルドをテストし、パイプライン内のリリース候補を更新するのに役立つmabl CLIコマンドを紹介します。
モバイルビルドファイルをアップロード
mabl mobile-build-files upload
コマンドは、新しいモバイルビルドファイルをアップロードして作成します。ファイル入力には、mablワークスペースにアップロードするファイルの相対パスを指定する必要があります。
ビルドファイルをアップロードすると、CLIは-maf
で終わるビルドファイルIDを返します。このIDを使用して、ビルドファイルをテスト環境に関連付け、ビルドファイルのオーバーライドを使用してプランを実行します。
mabl mobile-build-files upload <build-file-path>
オプション | 詳細 |
--branch | このモバイルビルドファイルがビルドされたブランチ。 |
--labels | テストを保存するときに使用するラベル。複数指定する場合はスペースで区切ります。 |
--platform | モバイルプラットフォーム。選択肢は "android" と "ios" です。デフォルトでは、ビルドファイルのバイナリの拡張子からプラットフォームが推定されます。 |
--version | モバイルビルドファイルのバージョン |
ビルドファイルをテスト環境と関連付ける
プラン実行のビルドファイルを更新するには、mabl mobile-build-files upload
コマンドから返されたIDを使用してmabl environment build-files update
コマンドを使用します。このコマンドは、アプリと環境のペアに関連付けられたビルドファイルを更新します。
例
# Upload a build file as a release candidate
mabl mobile-build-files upload sample-build.app --version 1.2
# Associate the app and environment used for scheduled plan runs with the new build file
mabl environments build-files update <env-id> --application-id <app-id> --build-file-id <build-file-id>
アプリケーションと環境の組み合わせに別のビルドファイルがすでに関連付けられている場合は、新しいビルドファイルに置き換えられます。このプロセスは、AndroidとiOSで異なります。たとえば、Androidビルドでmabl environments build-files update
を実行した場合、アプリケーションと環境の組み合わせに関連付けられたAndroidビルドファイルのみが更新されます。この動作はiOSビルドの場合も同じです。
注
mabl environments build-files update
コマンドでは、複数のビルドファイルにすでに関連付けられているアプリケーションと環境の組み合わせを更新することはできません。たとえば、アプリケーションと環境の組み合わせに2つのiOSビルドがすでに関連付けられている場合、CLIでこれらを更新することはできません。この場合は、mablアプリケーション ([テスト環境設定] > [アプリケーション]) を使用します。
ビルドファイルのオーバーライドを使用してプランを実行する
新しいビルドでプランをテストするには、mabl deployments create
を使用してビルドファイルのオーバーライドを行います。ビルドファイルのオーバーライドフラグはプラットフォーム固有であり、mabl mobile-build-files upload
から返されるIDが必要です。
オプション | 詳細 |
--android-app-file-id |
デプロイメントエベントで使用するAndroidアプリファイル |
--ios-app-file-id |
デプロイメントエベントで使用するiOSアプリファイル |
例
# Upload a build file that is currently under development mabl mobile-build-files upload sample-build.apk --version 3.4 # Run plans with a build file override to test out the build mabl deployments create -e <env-id> -a <app-id> --android-app-file-id <build-file-id>