モバイル制御とタッチイベント

EggPlant Functionalは、モバイルデバイスの被試験システム（SUT）としての使用に特化した多くのコマンドと関数を提供します。

ADBCall()関数

例：

例：

例：

パラメータ：関連パラメータの有無にかかわらず利用可能な、push、pull、shell、logcatなどのAndroid Debug Bridge（ADB）コマンドラインツールの呼び出し

挙動：この関数は、利用可能なAndroidデバイスに対してADB呼び出しを実行し、ADBコマンドから受け取ったアウトプットを返します。

Copy Fileコマンド

例：

例：

パラメータ：ソースファイルパスとコピー先のファイルパス

挙動：本コマンドは、ローカル機からSUTへ、またはSUTからローカル機へファイルをコピーします。パスの前に接頭辞SUT:をつけてSUTを指定します。このコマンドでは、SUT上のある場所から SUT上の別の場所へ、または別のSUTへファイルをコピーできない点に注意してください。Copy Fileは単一のファイルにのみ有効であり、フォルダのコピーはできません。

DoubleTapコマンド

例：

例：

パラメータ：オプションの1組の座標、画像またはテキスト（OCR）。

挙動：このコマンドは、現在の位置またはパラメータにより指定された位置のいずれかでダブルタップを実行します。このコマンドはDoubleClickコマンドと等価であり、モバイルデバイスで利用できます。モバイルデバイス上では一般的に、ダブルタップすると、アプリをズームすることができます。

挙動：DoubleTapコマンドにおけるタップ間のタイミングは、MouseDoubleClickDelayプロパティによって制御されます。MouseDoubleClickDelayを極端に長くすることで、DoubleTapを2つの異なるタップのように振る舞わせることができます。

例：

ExecuteRemoteCommand()コマンドと関数

例：

例：

例：

パラメータ：モバイルデバイスのSUT上で実行したいコマンド。

挙動：このExecuteRemoteCommand() コマンドおよび関数は、モバイルデバイスであるSUT上のコマンドを実行します。データを返したりするのにこのコマンドを利用できます。本コマンドは、同期（応答を待つ）または非同期（応答を待たない）コマンドのいずれかになります。コマンドを実行する方法は、モバイルOSに応じて以下のように異なります。

• Androidでは、実際のスマートフォン上でExecuteRemoteCommandがシェルコマンドとして実行されます。
• iOSでは、ExecuteRemoteCommandがJavaScriptとしてコマンドを実行し、Apple UIAutomation APIを呼び出します。

InstallAppコマンド

例：

例：

例：

パラメータ：applicationPathが常に必要となります。iOSでは、開発利用向けアプリにコード署名する（デベロッパー署名とも呼ばれる）場合は、オプションフィールドはprovisionPathとcertificateNameとなります。

挙動：このコマンドにより、アプリがモバイルデバイスにインストールされます。applicationPathパラメータを使って、インストールするアプリを特定します。provisionPathプロパティとcertificateNameプロパティを含める場合は、インストール前にアプリにデベロッパー署名するよう、必要に応じて本コマンドがiOS Gatewayに指示します。インストールするアプリケーションは、それらがeggPlant Functionalを実行している機器上にある場合は、ローカルパスで指定できます。すなわち、iOS Gatewayを実行している機器に既に存在するアプリのインストールは、パスに接頭辞SUT:をつけることで実行できます。本コマンドは、処理前にサーバーから完全なメッセージを受け取るまで待機します。

注：certificateNameプロパティ用の署名証明書は、InstallAppで使用する前にiOS Gateway機器にインストールする必要があります。

KillAppコマンド

例：

例：

例：

パラメータ：終了したいアプリの名前。

• iOS 7およびiOS 8では、アプリ名は開発プロビジョニングプロファイルを利用して署名されたアプリの名前またはバンドルIDとなります。
• iOS 9以降では、アプリ名はアプリの名前またはバンドルID（つまり、com.apple.camera）となります。
• Androidでは、アプリ名はパッケージ名となります。

挙動：このKillAppコマンドは特定のアプリを終了します。

注：

• KillAppコマンドを利用するには、eggPlant Functional 15.21以降において、iOS Gateway 2.6以降、Android Gatewayまたは組み込みAndroid VNCサーバが必要です。
• アプリのパッケージ名をAndroidデバイス上で確認するには、パッケージマネージャのpm list packagesコマンドとExecuteRemoteCommandコマンドを以下のように使用します。

• 例：

  put ExecuteRemoteCommand("pm list packages", WaitFor:10)

• iOS 8では、本コマンドを利用して特定のアプリを強制終了することはできません。
• iOSにおける本コマンドの利用に関する詳細情報は、iOS テストでよくある問題の解決ページのアプリの終了を参照してください。

LaunchAppコマンド

例：

例：

例：

パラメータ：ローンチしたいアプリの名前。

• iOS 7および8では、アプリ名はデベロッパー署名済みアプリの名前（またはSpringboard）、またはバンドルIDとなります。また、スペース、コロン、およびデバイス上のデベロッパー署名済みアプリの名前を後ろにつけて、iOSデバイスの名前を指定することも可能です。
• iOS 9以降では、アプリ名はアプリの名前またはバンドルIDとなります。
• Androidでは、アプリ名はパッケージ名となります。

挙動：このコマンドにより、アプリがモバイルデバイスにローンチされます。iOS Gatewayを介して接続されているiOS 7デバイスまたはiOS 8デバイスでは、本コマンドはデベロッパー署名済みアプリまたはSpringboardに制限されます。

例：

PinchInコマンド

例：

例：

例：

パラメータ：1組の座標、画像、またはテキスト（OCR）として表されるオプションのAtポイント、1組の座標、画像、またはテキスト（OCR)として表されるオプションのFromポイント、ズームの実行に要する時間を表すオプションのDuration（デフォルトは2秒）、Fromパラメータの代わりに使用され、ピクセルで表されるオプションのDistance（DistancもFromも指定しない場合は、デフォルトの距離は最も短い画面寸法の 4.5％となります）。

挙動：このPinchInコマンドは、画面上の2点をつまむように作動します。このピンチインの効果はズームアウトとなります（すなわち、画面上の画像が実際に小さくなります）。PinchInコマンドでは、Atポイントは静的または「固定」で、Fromポイントは Atポイントに向かって移動します。パラメータが全く設定されていない場合は、pinchinは画面中央で2秒間、4.5％のピンチ量で発生します。

例：

PinchOutコマンド

例：

例：

例：

パラメータ： 1組の座標または画像で表されるオプションのAt ポイント（デフォルトでは画面中央）、1組の座標または画像で表されるオプションのToポイント、ズームの実行に要する時間を表すオプションのDuration（デフォルトは2秒）、Toパラメータの代わりに使用され、ピクセルで表されるオプションのDistance。DistanceもToも指定しない場合は、デフォルトの距離は最も短い画面寸法の25％となります。

挙動：このPinchInコマンドは画面上の2点をつまむように作動します。ピンチアウトの効果はズームインとなります（すなわち、画面上の画像が実際に大きくなります）。PinchOutコマンドでは、Atポイントは静的または「固定」で、ToポイントはAtポイントから遠ざかるように移動します。パラメータが全く設定されていない場合は、pinchoutは画面中央で2秒間、20％のピンチ量で発生します。

Pressコマンド

例：

例：

パラメータ：オプションの1組の座標または画像。

挙動：本コマンドは、現在の位置またはパラメータにより指定された位置のいずれかでタップ＆ホールドを実行します。本コマンドはMouseButtonDownコマンドに相当し、モバイルデバイスで利用できます。

PressBackButtonコマンド

例：

パラメータ：なし。

挙動：Android 4.0.4以降を実行しているAndroidデバイスのBackボタンを押します。古いAndroidデバイスの場合は、モバイルコントロール用TypeTextキーワードを参照してください。

PressHomeButtonコマンド

例：

パラメータ：なし。

挙動：iOSデバイス上、およびAndroid 4.0.4以降を実行しているAndroidデバイス上でホームボタンを押します。古いAndroidデバイスの場合は、古いAndroidデバイスとモバイルコントロール用TypeTextキーワードを参照してください。

例：

本コマンドは、1行に入力する必要があります。行を2行に分けると、デバイスは2度押しではなく、2つの個別のホームボタン押下と認識します。

Rebootコマンド

例：

パラメータ：なし。

挙動：このRebootコマンドはモバイルデバイスで利用できます。本コマンドは、接続がアクティブなモバイルデバイスを再始動します。

Rebootコマンドをスクリプト内で使用する場合は、disconnectコマンドを本コマンドの直後に送信し、その後再接続することを推奨します。再接続する際は、デバイスの立ち上がり時間を考慮に入れる必要があります。例えば、 以下の例に示すように、repeatコマンドの中にconnectコマンドを設定し、成功するまで接続を試行させることができます。

例：

Releaseコマンド

例：

パラメータ：オプションの1組の座標、画像またはテキスト（OCR）。

挙動：このコマンドは、現在の位置または指定した位置のいずれかでPressコマンドを解放します。このコマンドはMouseButtonUpコマンドに相当し、モバイルデバイスで利用できます。

RotateLeft、RotateRightコマンド

例：

パラメータ：回転を生じさせるオプションのWaitFor時間。

挙動：RotateLeftコマンドは、モバイルデバイスの画面を現在のデバイスの向きから時計回りに1/4回転（90度）させ、RotateRightコマンドは画面を現在の向きから反時計回りに1/4回転（90度）させます。

SetDeviceLocation

例：

例：

パラメータ：デバイス上に設定したい位置の緯度および経度。

挙動：本コマンドにより、デバイスのGPSを上書きしたり、AndroidデバイスまたはiOSデバイス上に希望する位置を設定できます。Androidデバイスでは、本コマンドを作動させるためにdeveloper settingsを変更する必要があります。iOSデバイスでは、本コマンドを作動させるために位置サービスを有効にする必要があります。

SetDeviceOrientationコマンド

例：

パラメータ：設定したいデバイスの向き（LandscapeLeft、LandscapeRight、Portrait、PortraitUpsideDown）とオプションのWaitFor時間。

挙動：本コマンドにより、デバイスの向きがパラメータで指定した向きに変更されます。処理は、新しい向きになるまで待ってから続行されます。ただし、WaitFor遅延時間を設定してタイミングを制御することも可能です。SetDeviceOrientationコマンドがタイムアウトすると、例外が投げられます。

関連：

• GetDeviceOrientation：この関数を利用すると、デバイスの現在の向きに関する情報が返されます。

SwipeDown、SwipeLeft、SwipeRight、SwipeUpコマンド

例：

例：

例：

例：

パラメータ：スワイプの開始点を示すオプションの1組の座標、画像、またはテキスト（OCR）。

挙動：本コマンドにより、スワイプモーションが実行されます。スワイプは、指定された位置、画像またはテキスト（OCR）から開始するか、自動的に決定された画面端近くの位置から開始します。SwipeDownとSwipeUpは、それぞれ画面下部および画面上部付近の中央位置から自動的に開始し、画面の反対側の端に向けてスワイプします。SwipeLeftとSwipeRightは、それぞれ画面左と画面右付近の中央位置から自動的に開始し、画面の反対側に向けてスワイプします。この動きは、弧を描くようにモバイルデバイスを手でスワイプする動きを模倣しています。

Tapコマンド

例：

パラメータ：オプションの1組の座標または画像。

挙動：このコマンドは、現在の位置またはパラメータで指定された位置のいずれかでタップを実行します。このコマンドはClickコマンドに相当し、モバイルデバイスで利用できます。

挙動：Tapコマンドにおけるタップダウンとタップアップ間のタイミングは、MouseClickDelayグローバルプロパティによって制御されます。MouseClickDelayを極端に長くすることで、 TapをPress＆Releaseのように振る舞わせることができます：

例：

UninstallAppコマンド

例：

例：

パラメータ：アンインストールしたいアプリの名前。

• iOSでは、アプリ名はアプリの名前となります。
• Androidでは、アプリ名はパッケージ名となります。

挙動：このUninstallAppコマンドは、指定したアプリを削除します。

例：

 

This topic was last updated on 2月 01, 2019, at 11:13:23 午前.

Eggplant.io | Documentation Home | User Forums | Support | Copyright © 2019 Eggplant