ハートコア株式会社
 HeartCore Roboドキュメント一覧
 XCodeでのiOS自動化
 2023-02-22

「XCode経由のiOS接続」対応プラグイン

最終更新日：2023年2月22日

目次：
1. 概要
2. プラグインのセットアップ
3. 動作仕様


1.概要

注： 旧バージョンでのプラグイン導入についてはこちら（英語）をご覧ください。
iOSの仕様変更でHeartCore Roboにおけるプラグイン導入方法やデータの配置場所が変更されています。

「XCode経由のiOS接続」対応プラグインは、MacOS Monterey および Ventura以降のMacOSとiOS15以上のiOS機器を「XCode経由のiOS接続」した場合に対応するHeartCore Roboテストスクリプトに新たな機能を追加します。

主な機能：

このプラグインは、TPRスクリプトで書かれたテストスクリプトのために設計されました。Javaからプラグインスクリプトを呼び出すには、DefaultJavaTestScript.run() メソッドを使用するか、Java's Script Basicsドキュメントで説明されているスクリプトインスタンスの構成手法を使用します。
注意：iOS 12/13以降のアップデートで必要なメジャーアップデートの結果、このプラグインは以前のバージョン0.1とは互換性がありません。旧プラグインのドキュメントについては、こちらをご覧ください。



2.プラグインのセットアップ

このプラグインを使用するには、HeartCore Robo7.0.2以降が必要です。プラグインをインストールするには、以下からダウンロードしてください。

Version 0.5 : https://www.heartcore.co.jp/hcrobodesktop/download/iosx_v0.5.zip

  • ダウンロードしたプラグインファイルのZipファイルを解凍します。
  • 解凍後に作成されるフォルダ内の「iosx.jar」ファイルを、プラグインを利用したいTPRスクリプトファイルと同じフォルダ（ディレクトリ、標準ではプロジェクト内にあるTPRディレクトリになります）にコピーしてください。
  • コピー後にHeartCore Roboを再起動してください。

    • これでプラグインの利用準備が完了しました。
    プラグインをアンインストールするには、コピーしたJarファイルを削除するだけです。



    3.動作仕様

    プラグインに含まれるコマンドスクリプト:

    スクリプト名 説明
    com.tplan.iosx.ActiveApp アクティブなアプリケーションのバンドルIDを_IOS_ACTIVE_APP変数に格納する。
    com.tplan.iosx.Start iOS機器で指定したアプリケーションを起動する。
    com.tplan.iosx.Kill アプリケーションを終了、または停止させる。
    com.tplan.iosx.Orientation iOS機器の画面向きを縦または横の左側に設定する。
    com.tplan.iosx.RemapKeyboard iOS機器の画面に表示されるスクリーンキーボードをリマップする（v0.3以降）。
    com.tplan.iosx.LoadKeyboard ファイルからキーボードマップを読み込む（v0.3以降）。
    キーボードマップファイル作成方法の詳細については、「キーボードマッピング」の項を参照してください。
    com.tplan.iosx.GetAlert 画面上にシステムアラートウィンドウがあるかどうかをテストする
    テスト後に表示されたテキストとボタンをそれぞれ
    _IOS_ALERT_TEXT, _IOS_ALERT_BUTTON_COUNT, _IOS_ALERT_BUTTON 変数として返す (v0.4 以降)。
    com.tplan.iosx.DismissAlert アラートを解除または受け入れ、指定されたボタンで閉じる。
    アラートがない場合はスクリプトは何もしない（0.4以降）。

    プラグインスクリプトは、Runコマンドを使用してTPRテストスクリプトから呼び出されます。コマンドインスタンスは、Command Wizard ツールを使用して簡単に作成することができます。
    既存の Run コマンドを編集するには、コマンドを右クリックし、コンテキストメニューから プロパティ を選択します。プラグインスクリプトはJavaクラスのため、プロパティ画面から設定する場合は「スクリプトクラス」に設定してください。



    例：

    //まずはiosx.jarをスクリプト上に取り込みます
    Include "iosx.jar"

    //mobile safariを起動します
    Run "com.tplan.iosx.Start" bundleid="com.apple.mobilesafari"

    //機器のスクリーンを回転させます
    Run "com.tplan.iosx.Orientation" orientation="landscape"

    //処理色々...

    //画面上でシステムアラートが表示されていた場合に各プロパティを取得します。
    Run "com.tplan.iosx.GetAlert"

    //（アラートウインドウが表示されている場合は）アラートウィンドウに「This is my text」テキストを入力し、OKボタンを押します。
    //設定するパラメータは上記で取得した各変数になります。
    Run "com.tplan.iosx.DismissAlert" button="OK" text="This is my text" accept="true"

    //mobile safariを終了します
    Run "com.tplan.iosx.Kill" bundleid="com.apple.mobilesafari"