コマンド・ラインからの Android アプリケーション用のモバイル・テストの実行

コマンド・ライン・インターフェースを使用することで、デスクトップ・クライアントを使用することなくモバイル・テストを実行することができます。 XML ファイルへの完全パスを指定する -varfile パラメーターをコマンドで使用する必要があります。 XML ファイルには、変数の名前と値のペアが含まれています。 この変数は、Android デバイスまたはエミュレーターが接続されているコンピューターへのパスと、接続されたデバイス自動モバイル・テストを実行するために必要なその他の構成を指定します。

コマンドの実行

モバイル・テストを実行するコマンドをコマンド・ラインから実行するためには、モバイル・デバイスが接続されているコンピューターの詳細を含む変数ファイルを作成しておく必要があります。 モバイル・テストの記録も行っておく必要があります。

次のコマンドを発行して、モバイル・テストをコマンド・ラインから実行できます。

cmdline -workspace <workspace_full_path> -project <proj_relative_path> -eclipsehome <eclipse_full_path> -plugins <plugin_full_path> -suite <suite_relative_path> -importzip <full_path.zip> -varfile <variable_file_full_path> -configfile <file_full_path> -results <result_file> -overwrite <{"true" | "false"}> -quiet -vmargs <JVM_args> -publish <serverURL#project.name=projectName -publish_for {ALL,PASS,FAIL,ERROR, INCONCLUSIVE}> -labels <labelname1, labelname2> -exportlog <log_full_path> -exportstats <local_dir_path> -exportstatshtml <local_dir_path> -exportstatsformat <name of the file format> -compare <"result_path1, result_path2"> -exportstatreportlist <stats_list> -execsummary <local_dir_path> -execsummaryreport <reportID> -usercomments <"any user comment"> -publishreports <"FT, STATS, TESTLOG"> -stdout -swapdatsets <existing_dataset_file_path:new_dataset_file-path>

Important:
モバイル・テストを実行するコマンドを使用する場合は、以下の条件を満たしていることを確認する必要があります。
  • Android デバイスまたはエミュレーターが接続しているコンピューター、サーバー、またはクラウドの詳細を含む変数ファイルを使用している。
  • 変数ファイルの詳細をコマンドで指定している。

変数ファイルの作成

Android デバイス/エミュレーターへの接続に必要となる変数名/変数値ペアを含む変数ファイルを作成できます。 以下のコンピューター、サーバー、またはモバイル・クラウドに接続されている Android デバイスまたはエミュレーターに接続し、モバイル・テストを実行できます。

Test UI をインストールしたコンピューターの変数ファイル

XML フォーマットで変数ファイルを作成して、選択したデバイスでモバイル・テストを実行するために必要となる詳細を指定できます。

また、モバイル・デバイスで使用されるリソースの特定パラメーターについて Test UI がメトリックを収集できるように詳細を追加することもできます。

構文/構造のサンプルを以下に示します。
<?xml version="1.0" encoding="UTF-8"?>
<inits>
<variable_init value="<Android device or emulator name>" name="Mobile_Device_Selection"/>
<variable_init value="true" name="rm.selected"/>
<variable_init value ="any value equal to or above 1000" name="rm.polling.interval"/>
</inits>
XML サンプルで言及されている属性の変数と値については、以下の表を参照してください。
変数 アクション サンプル値
Mobile_Device_Selection コンピューターに接続されているAndroidデバイスまたはエミュレーターの名前を指定します。 Emulator:Pixel_2_API_28
rm.selected

オプション。 モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する場合は、値をtrueに設定します。 リソース監視メトリクスの収集とデータのグラフィカル表示は、単一のデバイスで単一のテストを実行する場合にのみサポートされます。

はい
rm.polling.interval

モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する間隔をミリ秒単位で指定します。 最小入力可能値は 1000 ミリ秒です。 属性 rm.selectedtrue に設定した場合は、値を入力します。

1000

この後に、コマンドにおいて -varfile オプションで変数ファイルを使用して、コマンド・ラインからテストを実行できます。

UI Test Agent の変数ファイル

UI Test Agent をインストールして Android デバイス/エミュレーターを接続したリモート・コンピューターについて詳細を指定する変数ファイルとして XML ファイルを作成できます。

また、モバイル・デバイスで使用されるリソースの特定パラメーターについて Test UI がメトリックを収集できるように詳細を追加することもできます。

構文/構造のサンプルを以下に示します。

<?xml version="1.0" encoding="UTF-8"?>
<inits>
<variable_init value="<Android device or emulator name>" name="Mobile_Device_Selection"/>             
<variable_init value="<UI Test Agent host URL>" name="appium.server.host"/>
<variable_init value="<port number>" name="appium.server.port"/>
<variable_init value="true" name="rm.selected"/>
<variable_init value ="any value equal to or above 1000" name="rm.polling.interval"/>
</inits>
XML サンプルで言及されている属性の変数と値については、以下の表を参照してください。
変数 アクション サンプル値
Mobile_Device_Selection コンピューターに接続されているAndroidデバイスまたはエミュレーターの名前を指定します。 Emulator:Pixel_2_API_28
appium.server.host これは、UI テスト・エージェントのインストール先となったリモート・コンピューターのホスト名または IP アドレスを指定します。
Note:
この変数のデフォルト値は 127.0.0.1 です。 値を指定しない場合、再生中にはデフォルト値が使用されます。
10.115.50.61
appium.server.port リモート・マシンにインストールされた UI Test Agent のポート番号を指定します。 7082
rm.selected

オプション。 モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する場合は、値をtrueに設定します。 リソース監視メトリクスの収集とデータのグラフィカル表示は、単一のデバイスで単一のテストを実行する場合にのみサポートされます。

はい
rm.polling.interval

モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する間隔をミリ秒単位で指定します。 最小入力可能値は 1000 ミリ秒です。 属性 rm.selectedtrue に設定した場合は、値を入力します。

1000

この後に、コマンドにおいて -varfile オプションで変数ファイルを使用して、コマンド・ラインからテストを実行できます。

BitBar Cloud の変数ファイル

BitBar クラウドの詳細を指定する変数ファイルとして XML ファイルを作成できます。

また、モバイル・デバイス/アプリケーションで使用されるリソースの特定パラメーターについて Test UI がメトリックを収集できるように詳細を追加することもできます。
Restriction:
テストが AFT スイートとして実行される場合、モバイル・デバイス・リソースのリソース・モニター・メトリックは収集されません。
構文/構造のサンプルを以下に示します。
<?xml version="1.0" encoding="UTF-8"?>
<inits>
<variable_init value="<BitBar device name>" name="Mobile_Device_Selection"/>
<variable_init value="<BitBar API key>" name="bitbar.apikey"/>
<variable_init value="<BitBar host URL>" name="bitbar.host"/>
<variable_init value="<project name>" name="bitbar.project"/>
<variable_init value="<test name>" name="bitbar.testrun"/>
<variable_init value="true" name="rm.selected"/>
<variable_init value ="any value equal to or above 1000" name="rm.polling.interval"/>
</inits>
Note:
BitBar クラウドに接続されているデバイスで AFT スイートを実行する場合は、変数 Mobile_Device_Selection を使用せずに XML ファイルを作成します。
変数とサンプル値については、次の表を参照してください。
変数 アクション サンプル値
Mobile_Device_Selection BitBarクラウドに接続されるモバイル・デバイスの名前を指定します。 BitBar:Google Pixel 2
bitbar.apikey BitBar Cloud との接続を認証するために BitBar アカウント用に生成されたユーザー・トークンを指定します。 LkBldnjcnzrIcwWZpCZZxy
bitbar.host BitBar クラウド・インスタンスのホスト名を指定します。 appium.bitbar.com
bitbar.project 記録されたテストを含むプロジェクトの名前を指定します。 PlaybackMobile
bitbar.testrun テスト実行で BitBar ダッシュボードに表示するテスト実行名を指定します。 CLIExecution
rm.selected

オプション。 モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する場合は、値をtrueに設定します。 リソース監視メトリクスの収集とデータのグラフィカル表示は、単一のデバイスで単一のテストを実行する場合にのみサポートされます。

はい
rm.polling.interval

モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する間隔をミリ秒単位で指定します。 最小入力可能値は 1000 ミリ秒です。 属性 rm.selectedtrue に設定した場合は、値を入力します。

1000

この後に、コマンドにおいて -varfile オプションで変数ファイルを使用して、コマンド・ラインからテストを実行できます。

BrowserStack Cloud用の変数ファイル

BrowserStack Cloudの詳細を指定する変数ファイルとしてXMLファイルを作成できます。

また、モバイル・デバイス/アプリケーションで使用されるリソースの特定パラメーターについて Test UI がメトリックを収集できるように詳細を追加することもできます。
Restriction:
テストが AFT スイートとして実行される場合、モバイル・デバイス・リソースのリソース・モニター・メトリックは収集されません。
構文/構造のサンプルを以下に示します。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<inits id="N2D6E3E008FC11EDAE07D38ACD9588FD" type="com.ibm.rational.test.ft.aftsuite">
<group>
<tests>
<test path="/UI1/Tests/apidemos1.testsuite"/>
</tests>
<devices>
<device id="BrowserStack : Google Pixel 7 Pro" />
<device id="BrowserStack : Samsung Galaxy Tab S8" />
</devices>
</group>
</inits>
XML サンプルで言及されている属性の変数と値については、以下の表を参照してください。
変数 アクション サンプル値
device_id BrowserStack Cloudに接続されているモバイル・デバイスの名前を指定します。 BrowserStack : Google Pixel 7 Pro
browserstack.project 記録されたテストを含むプロジェクトの名前を指定します。 PlaybackMobile
testpath テスト実行のBrowserStackダッシュボードに表示する必要があるテスト実行のパスを指定します。 CLIExecution
rm.selected

オプション。 モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する場合は、値をtrueに設定します。 リソース監視メトリクスの収集とデータのグラフィカル表示は、単一のデバイスで単一のテストを実行する場合にのみサポートされます。

はい
rm.polling.interval

モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する間隔をミリ秒単位で指定します。 最小入力可能値は 1000 ミリ秒です。 属性 rm.selectedtrue に設定した場合は、値を入力します。

1000

この後に、コマンドにおいて -varfile オプションで変数ファイルを使用して、コマンド・ラインからテストを実行できます。

LambdaTest クラウド向け変数ファイル

LambdaTest クラウドの詳細を指定する変数ファイルとして XML ファイルを作成できます。

また、モバイル・デバイス/アプリケーションで使用されるリソースの特定パラメーターについて Test UI がメトリックを収集できるように詳細を追加することもできます。
Restriction:
テストが AFT スイートとして実行される場合、モバイル・デバイス・リソースのリソース・モニター・メトリックは収集されません。
構文/構造のサンプルを以下に示します。
<?xml version="1.0" encoding="UTF-8"?>
<inits>
	<variable_init value="user1" name="lambdatest.username"/>
	<variable_init value="api.lambdatest.com" name="lambdatest.host"/>
	<variable_init value="jhdskjhkhjkhiefiwzERBaUb1uvHzL4z52lBIX2tF" name="lambdatest.apikey"/>
	<variable_init value="CMDLINETest" name="lambdatest.project"/>
	<variable_init value="LambdaTest:Pixel 7 Pro" name="Mobile_Device_Selection"/>
</inits>
XML サンプルで言及されている属性の変数と値については、以下の表を参照してください。
変数 アクション サンプル値
lambdatest.username LambdaTest アカウントのユーザ名を指定します。 user1
lambdatest.host LambdaTest クラウド・インスタンスのホスト名を指定します。 api.lambdatest.com
lambdatest.apikey LambdaTest クラウドとの接続を認証するために LambdaTest アカウント用に生成されたユーザー・トークンを指定します。 jhdskjhkhjkhiefiwzERBaUb1uvHzL4z52lBIX2tF
lambdatest.project LambdaTest ダッシュボードに表示される必要があるテスト実行のパスを指定します。 CMDLINETest
Mobile_Device_Selection LambdaTest クラウドに接続されているモバイル・デバイスの名前を指定します。 LambdaTest : Google Pixel 7 Pro

この後に、コマンドにおいて -varfile オプションで変数ファイルを使用して、コマンド・ラインからテストを実行できます。

Perfecto Cloud用変数ファイル

Perfecto クラウドの詳細を指定する変数ファイルとして XML ファイルを作成できます。

また、モバイル・デバイスで使用されるリソースの特定パラメーターについて Test UI がメトリックを収集できるように詳細を追加することもできます。
Restriction:
AFT スイートにおけるモバイル・テストに関しては、モバイル・デバイス・リソースのリソース・モニター・メトリックは収集されません。
構文/構造のサンプルを以下に示します。
<?xml version="1.0" encoding="UTF-8"?>
<inits>
<variable_init value="<Perfecto device name>" name="Mobile_Device_Selection"/>
<variable_init value="<security token>" name="perfecto.securitytoken"/>
<variable_init value="<perfecto host URL>" name="perfecto.host"/>
<variable_init value="true" name="rm.selected"/>
<variable_init value ="any value equal to or above 1000" name="rm.polling.interval"/>
</inits>
Note:
Perfecto クラウドに接続されているデバイスで AFT スイートを実行する場合は、変数 Mobile_Device_Selection を使用せずに XML ファイルを作成します。
XML サンプルで言及されている属性の変数と値については、以下の表を参照してください。
変数 アクション サンプル値
Mobile_Device_Selection Perfecto Cloudに接続されているモバイル・デバイスの名前を指定します。 Perfecto:R48904TNSAZ
perfecto.securitytoken Perfectoアカウント用に生成されたユーザー・トークンを指定して、Perfecto Cloudとの接続を認証します。 LkBldnjcnzrIcwWZpCZZxy
perfecto.host Perfecto CloudのURLを指定します。 partners.perfectomobile.com
rm.selected

オプション。 モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する場合は、値をtrueに設定します。 リソース監視メトリクスの収集とデータのグラフィカル表示は、単一のデバイスで単一のテストを実行する場合にのみサポートされます。

はい
rm.polling.interval

モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する間隔をミリ秒単位で指定します。 最小入力可能値は 1000 ミリ秒です。 属性 rm.selectedtrue に設定した場合は、値を入力します。

1000

この後に、コマンドにおいて -varfile オプションで変数ファイルを使用して、コマンド・ラインからテストを実行できます。

pCloudy Cloud用変数ファイル

pCloudy Cloudの詳細を指定する変数ファイルとしてXMLファイルを作成できます。

また、モバイル・デバイスで使用されるリソースの特定パラメーターについて Test UI がメトリックを収集できるように詳細を追加することもできます。
Restriction:
AFT スイートにおけるモバイル・テストに関しては、モバイル・デバイス・リソースのリソース・モニター・メトリックは収集されません。
構文/構造のサンプルを以下に示します。
<?xml version="1.0" encoding="UTF-8"?>
<inits>
<variable_init value="<pCloudy device name>" name="Mobile_Device_Selection"/>
<variable_init value="<api key>" name="pcloudy.apikey"/>
<variable_init value="<pcloudy host URL>" name="pcloudy.host"/>
<variable_init value="<pcloudy user name>" name="pcloudy.username"/>
<variable_init value="true" name="rm.selected"/>
<variable_init value ="any value equal to or above 1000" name="rm.polling.interval"/>
</inits>
Note:
PCloudy クラウドに接続されているデバイスで AFT スイートを実行する場合は、変数 Mobile_Device_Selection を使用せずに XML ファイルを作成します。
XML サンプルで言及されている属性の変数と値については、以下の表を参照してください。
変数 アクション サンプル値
Mobile_Device_Selection pCloudy Cloudに接続されたモバイル・デバイスの名前を指定します。 pCloudy:SAMSUNG_GalaxyS8_Android_7.0.0_3ced4
pcloudy.apikey Perfectoアカウント用に生成されたユーザー・トークンを指定して、Perfecto Cloudとの接続を認証します。 csv7wxjyyzzgrzbqym62cvfg
pcloudy.host これは、pCloudy CloudインスタンスのURLを指定します。 device.pcloudy.com
pcloudy.username pCloudy アカウントのユーザー名を指定します。 myUserName@pcloudy
rm.selected

オプション。 モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する場合は、値をtrueに設定します。 リソース監視メトリクスの収集とデータのグラフィカル表示は、単一のデバイスで単一のテストを実行する場合にのみサポートされます。

はい
rm.polling.interval

モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する間隔をミリ秒単位で指定します。 最小入力可能値は 1000 ミリ秒です。 属性 rm.selectedtrue に設定した場合は、値を入力します。

1000

この後に、コマンドにおいて -varfile オプションで変数ファイルを使用して、コマンド・ラインからテストを実行できます。

複数のモバイル・クラウドでモバイル・テストを実行するための変数ファイル

複数のモバイル・クラウドに接続されているデバイスでモバイル・テストを実行する場合は、XMLファイルを作成して変数ファイルとして使用できます。 モバイル・クラウドに Test UI が接続できるようにする各モバイル・クラウドの詳細を変数ファイルに指定する必要があります。

モバイル・クラウドの詳細を xml ファイルとして構成できます。 次のサンプル XML ファイルを使用すれば、モバイル・クラウドの名前/値ペアの詳細を入力できます。

例えば、BitBar クラウドと pCloudy クラウドで実行する場合は、この XMLファイルを編集し、Perfecto クラウドの詳細を削除します。

<?xml version="1.0" encoding="UTF-8"?>
<inits>
<variable_init value="<BitBar API key>" name="bitbar.apikey"/>
<variable_init value="<BitBar host URL>" name="bitbar.host"/>
<variable_init value="<project name>" name="bitbar.project"/>
<variable_init value="<test name>" name="bitbar.testrun"/>
<variable_init value="<api key>" name="pcloudy.apikey"/>
<variable_init value="<pcloudy host URL>" name="pcloudy.host"/>
<variable_init value="<pcloudy user name>" name="pcloudy.username"/>
<variable_init value="<security token>" name="perfecto.securitytoken"/>
<variable_init value="<perfecto host URL>" name="perfecto.host"/>
</inits>
Note:
使用するモバイル・クラウドの詳細のみを入力する必要があります。

XML ファイルに入力する必要があるモバイル・クラウドの詳細については、以下の表を参照してください。

モバイル・クラウド 変数の名前 説明
BitBar Cloud bitbar.apikey これは、BitBar クラウドとの接続を認証するために BitBar アカウント用に生成されたユーザー・トークンを指定します。
bitbar.host BitBar クラウド・インスタンスのホスト名を指定します。
bitbar.project これは、記録されたテストを含むプロジェクトの名前を指定します。
bitbar.testrun これは、テスト実行の BitBar ダッシュボードに表示されなければならないテスト実行の名前を指定します。
pCloudy Cloud pcloudy.apikey これは、正常な接続のためにユーザー名を認証するための pCloudy アカウントの API 鍵を指定します。
pcloudy.host これは、pCloudy クラウド・インスタンスの URL を指定します。
pcloudy.username これは、pCloudy アカウントのユーザー名を指定します。
Perfecto クラウド perfecto.securitytoken これは、Perfecto クラウドとの接続を認証するために Perfecto アカウント用に生成されたユーザー・トークンを指定します。
perfecto.host これは、Perfecto クラウドの URL を指定します。

この後に、コマンドにおいて -varfile オプションで変数ファイルを使用して、コマンド・ラインからテストを実行できます。