コマンド・ラインからの 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>
- 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>| 変数 | アクション | サンプル値 |
|---|---|---|
| Mobile_Device_Selection | コンピューターに接続されているAndroidデバイスまたはエミュレーターの名前を指定します。 | Emulator:Pixel_2_API_28 |
| rm.selected |
オプション。 モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する場合は、値をtrueに設定します。 リソース監視メトリクスの収集とデータのグラフィカル表示は、単一のデバイスで単一のテストを実行する場合にのみサポートされます。 |
はい |
| rm.polling.interval |
モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する間隔をミリ秒単位で指定します。 最小入力可能値は 1000 ミリ秒です。 属性 rm.selected を true に設定した場合は、値を入力します。 |
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>
| 変数 | アクション | サンプル値 |
|---|---|---|
| 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.selected を true に設定した場合は、値を入力します。 |
1000 |
この後に、コマンドにおいて -varfile オプションで変数ファイルを使用して、コマンド・ラインからテストを実行できます。
BitBar Cloud の変数ファイル
BitBar クラウドの詳細を指定する変数ファイルとして XML ファイルを作成できます。
<?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>| 変数 | アクション | サンプル値 |
|---|---|---|
| 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.selected を true に設定した場合は、値を入力します。 |
1000 |
この後に、コマンドにおいて -varfile オプションで変数ファイルを使用して、コマンド・ラインからテストを実行できます。
BrowserStack Cloud用の変数ファイル
BrowserStack Cloudの詳細を指定する変数ファイルとしてXMLファイルを作成できます。
<?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>
| 変数 | アクション | サンプル値 |
|---|---|---|
| device_id | BrowserStack Cloudに接続されているモバイル・デバイスの名前を指定します。 | BrowserStack : Google Pixel 7 Pro |
| browserstack.project | 記録されたテストを含むプロジェクトの名前を指定します。 | PlaybackMobile |
| testpath | テスト実行のBrowserStackダッシュボードに表示する必要があるテスト実行のパスを指定します。 | CLIExecution |
| rm.selected |
オプション。 モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する場合は、値をtrueに設定します。 リソース監視メトリクスの収集とデータのグラフィカル表示は、単一のデバイスで単一のテストを実行する場合にのみサポートされます。 |
はい |
| rm.polling.interval |
モバイル・アプリケーションまたはデバイスによって使用されるリソースの特定のパラメーターのメトリックを収集する間隔をミリ秒単位で指定します。 最小入力可能値は 1000 ミリ秒です。 属性 rm.selected を true に設定した場合は、値を入力します。 |
1000 |
この後に、コマンドにおいて -varfile オプションで変数ファイルを使用して、コマンド・ラインからテストを実行できます。
LambdaTest クラウド向け変数ファイル
LambdaTest クラウドの詳細を指定する変数ファイルとして XML ファイルを作成できます。
<?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>
| 変数 | アクション | サンプル値 |
|---|---|---|
| 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 ファイルを作成できます。
<?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>| 変数 | アクション | サンプル値 |
|---|---|---|
| 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.selected を true に設定した場合は、値を入力します。 |
1000 |
この後に、コマンドにおいて -varfile オプションで変数ファイルを使用して、コマンド・ラインからテストを実行できます。
pCloudy Cloud用変数ファイル
pCloudy Cloudの詳細を指定する変数ファイルとしてXMLファイルを作成できます。
<?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>| 変数 | アクション | サンプル値 |
|---|---|---|
| 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.selected を true に設定した場合は、値を入力します。 |
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>
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 オプションで変数ファイルを使用して、コマンド・ラインからテストを実行できます。