iOS Over Xcode Extension Plugin
この拡張機能の機能は、Robot 7.1以降、Mobileコマンドとして標準でサポートされています。このプラグインは今後メンテナンスされません。
1. 概要
iOS Over Xcode Extension Pluginは、iOS 10以降向けのiOS Over Xcode接続を利用するT-Plan Robot Enterpriseテストスクリプトに新しい機能を追加します。具体的には:
-
アプリケーション管理 - iOSデバイス上のアプリケーションの起動と非アクティブ化
-
デバイス制御 - 画面の向きの切り替え、特殊なジェスチャー
-
デバイスのキーボードマッピング(v0.3以降)
このプラグインは主にTPR言語で書かれたテストスクリプト向けに設計されています。Javaからプラグインスクリプトを呼び出すには、DefaultJavaTestScript.run()メソッドを使用するか、Java Script Basicsドキュメントに記載されているスクリプトインスタンスのアプローチを使用してください。
ご質問やご提案がございましたら、T-Plan supportまでご連絡ください。T-Planが提供する他のプラグインの一覧については、こちらをご覧ください。
注: iOS 12/13アップデートに伴う大規模な更新の結果、このプラグインは以前のバージョン0.1とは互換性がありません。旧プラグインのドキュメントについては、こちらをご覧ください。
2. プラグインのインストール
このプラグインにはT-Plan Robot 5.0.6以降が必要です。プラグインをインストールするには、以下からダウンロードしてください:
プラグインをインストールするには:
-
アーカイブを解凍し、
iosx.jarファイルをRobotインストールディレクトリ内のplugins/ディレクトリにコピーします。これにより、Robotは起動時にクラスを読み込みます。プラグインの古いバージョンが残っていないことを確認してください。 -
Robotを起動または再起動します。
プラグインをアンインストールするには、ファイルを削除するだけです。
3. 使用方法
このプラグインには以下が含まれます:
|
スクリプト名
|
説明
|
|
|
アクティブなアプリケーションのバンドルIDを_IOS_ACTIVE_APP変数に保存します。 |
|
|
iOSデバイス上でアプリケーションを起動します。 |
|
|
アプリケーションを強制終了(非アクティブ化)します。 |
|
|
画面の向きを縦向きまたは横向き(左)に設定します。 |
|
|
デバイス画面に表示されるキーボードを再マッピングします(v0.3以降)。 |
|
|
ファイルからキーボードマップを読み込みます(v0.3以降)。keymapファイルの作成方法の詳細については、Keyboard Mappingのトピックを参照してください。 |
|
|
画面上にシステムアラートウィンドウが存在するかどうかをテストし、そのテキストとボタンを_IOS_ALERT_TEXT、_IOS_ALERT_BUTTON_COUNT、_IOS_ALERT_BUTTON<n>変数として返します(0.4以降)。 |
|
|
アラートを閉じるか承認するか、指定したボタンで閉じます。アラートが存在しない場合、スクリプトは何も行いません(0.4以降)。 |
プラグインスクリプトは、Runコマンドを使用してTPRテストスクリプトから呼び出します。コマンドインスタンスは、Command Wizardツールを使用して簡単に作成できます。既存のRunコマンドを編集するには、それを右クリックし、コンテキストメニューからPropertiesを選択します。
例:
// iosx.jarがスクリプトフォルダにあることを前提とします
Include "iosx.jar"
// Safariを起動します
Run "com.tplan.iosx.Start" bundleid="com.apple.mobilesafari"
// ここでテストを実行します
// ...
// 画面を横向きに回転します
Run "com.tplan.iosx.Orientation" orientation="landscape"