XCodeを利用したiOSの自動化(XCode経由のiOS接続)

1.WebDriverAgentのダウンロード：

• 前バージョンからのアップグレードではありません。旧版を削除し新しいXCodeプロジェクトを設定してください。

2.プロジェクトのセットアップ手順：

• 初回設定：プロジェクトに関しては リンクURLでの設定手順（または詳細な手順はこちらも確認)（ともに英語）に従ってください。
  以下は、導入のための簡単な解説です。※文章中に「＄〜」とあるのはターミナルでの入力コマンドです($は入力しません)。
  
• プロジェクトの依存関係にあるアプリケーションのインストール：以下はnpm、Carthage、およびGitの推奨手順：
  
• ターミナルを開き、Homebrewをインストールします。Homebrewのインストールはページ内の手順で行ってください。
  下記記載テキストは一例です：
      $ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  
• Homebrewを使用してNPM、Git、およびCarthageをインストールします。
      $ brew install node
    $ brew install git
    $ brew install carthage
  
• ターミナルでWDAのホームディレクトリに切り替えてブートストラップスクリプトを実行します。Scriptsディレクトリ内にbootstrap.shが存在しない場合はこの手順をスキップできます。
     $ ./Scripts/bootstrap.sh
• WDAプロジェクトをアップグレードした場合は上記セットアップを繰り返す：(Homebrew、NPM、Git、Carthageのアップグレード作業後)
• ターミナルからWDAホームフォルダーに移動し、 ./Scripts/bootstrap.sh のスクリプトを実行します。依存関係をアップグレードするように求められたら、スクリプトを再実行してください。Scriptsディレクトリ内にbootstrap.shが存在しない場合はこの手順をスキップできます。
  

3. XCodeのセットアップ手順：

以下の場合はこの項のXCodeセットアップを繰り返す必要があります：

• WebDriverAgentプロジェクトを更新または再ダウンロードした後。
• XCodeが更新された後。
• ターゲットデバイス上のiOSが更新された後。
• 新しいデバイスをセットアップする必要がある場合。

XCodeのバージョンによって表示画面が大きく変更される可能性があることにご注意ください。

手順：

• XCodeを起動します。 アプリケーションフォルダからWDAプロジェクトファイルを開きます。 
• XCodeプロジェクトの場合：

1. トップバーのWebDriverAgentRunnerスキームとターゲットデバイスを選択します。
2. WebDriverAgentLibターゲットを選択します。「署名を自動的に管理する」 オプションがオンで、AppleDeveloper登録されている有効なチームが設定されていることを確認します。
3. WebDriverAgentRunnerターゲットを選択します。「署名を自動的に管理する」 オプションがオンで、AppleDeveloper登録されている有効なチームが設定されていることを確認します。

WebDriverAgentLibでGeneralタブを選択します。

iOSマシンの動作OSバージョンを設定します。

MacOSのバージョンを設定します。オプションがオンで、AppleDeveloper登録されている有効なチームが設定されていることを確認します。

• View-> Debug Area-> Activate Consoleでデバッグコンソールを開きます。
• [XCode]メニューの[ Product-> Test ]を選択します。すべてが正常に動作するとアプリケーションはテストモードで起動し、XCode内のコンソール出力の下部に下記のような記述行が含まれ表示されます：
  ※記載されているhttp://~の部分は接続設定ごとで異なります。

20xx-xx-xx xx:xx:xx.xxxxx+0100 WebDriverAgentRunner-Runner[785:276949] ServerURLHere->http://192.168.1.3:8100<-ServerURLHere

• WDAサーバーが動作していることを確認するには、上記記載の行に含まれるURL（IPアドレス）を使用しMacOSのSafariで以下のような記載でURL（IPアドレス）を開きます。Safari上で「I-AM-ALIVE」と表示されれば接続は成功しています。 Safariにうまく表示されない場合でも、iOS上でWebDriverAgentが動作していればHeartCore RoboとiOS機器を接続することが可能です。
  また、この作業後iOSの画面上に「WebDriverAgentRunner」というアイコン画像のないアイコンが作成されますがこれは手動での接続時に利用できるアプリケーションになります。

例：http://192.168.1.3:8100/health

この作業を行った後は、HeartCofre Robo接続前にXCodeを実行する必要はありません。また、WebDriverAgentアプリケーションに関してもターゲットiOSデバイスに事前インストールする必要はありません。HeartCore Roboが接続時にXCode CLIツールを起動し、XCode CLIツールを使用してデバイスへ自動インストールします。上記プロセスは、WDAプロジェクトがXCode CLIツールを使用して構築および実行されるように正しく設定されていることを確認するためにのみ必要です。また、接続開始時間を短縮するコードをコンパイルしてくれます。

4.HeartCore Roboでの接続

ログイン画面で「XCode経由のiOS接続」を選択して接続します。

接続時に以下情報を設定する必要があります：

• 接続先のデバイスの名前。MacとiOS機器が正しく接続されていれば接続デバイスの選択リストに機器名が表示されます。
  v5.0.6以降では{_IOS_DEVICES}変数を利用してロボット実行時に必要なデバイス（リスト）名を取得することができます。
• XCodeを使用して適切に構成され、かつ接続iOSデバイスに対して正しく設定されたWDAプロジェクトのパス

注：キーボードマッピングは非常に遅く、10分以上かかる場合があります。HeartCore Roboで一度接続した後にキーマップオプションを保存し再接続時に使用すれば、繰り返し接続の際に起こる遅延を回避できます。

5.トラブルシューティング

• iOSデバイスに同梱のオリジナルのLightning USBケーブルを使用してください。AppleはiOSを他社製品のケーブルで接続拒否する場合がしばしば報告されています。
• ケーブルを直接MacのUSBポートに接続します。USBスイッチまたはハブを使用しないでください。
• Apple社のソフトウェアバージョンアップにより、接続手順が変わったり接続そのものができない場合が報告されています。詳細は弊社サポートまでお問い合わせください。

6.自動化

接続
テストスクリプトからiOSデバイスに接続する場合は、Connectコマンド（TPRスクリプト）またはconnect（）メソッド（Javaテストスクリプト）を使用します。 引数の URL は "xcode://localhost" の形式で、デバイス名 ("device") と WebDriverAgent のプロジェクトフォルダへのパス ("project") を指定する必要があります。"app" パラメータはオプションです。ローカルに保存された iOS アプリケーション (.ipa) をデバイスにインストールすることができます。その場合に、アプリケーションはWDAのデプロイメントに使用したのと同じ設定（証明書）で署名されている必要があります。
たとえば、次のコマンド/メソッド呼び出しは、最初に検出されたデバイスに接続します：

TPRテストスクリプトの例：     Connect "XCode://localhost?device=My%20iPhone&project=/Users/Joe/WebDriverAgent"

タッチスクリーンのサポート

• マウスクリックは、タッチスクリーンタップにマッピングされます。v4.4.2以降、ダブルクリック（タップ）とロングクリック（ロングタップ、「タッチアンドホールド」）がサポートされています。
  
• マウスドラッグはスワイプにマッピングされます。
  
• マウスホイールイベントはサポートされず、無視されます。
  
• 他のタッチスクリーンジェスチャーは、「XCode経由のiOS接続」対応プラグインを介してサポートされることがあります。
• Gestureコマンドを使ったモバイル機器のジェスチャー自動化にv6.2以降で対応しました。

キーボードサポート

HeartCore Roboにおいて、MacとiOS機器はライトニングケーブルでリモート接続されています。その際にはiOS機器のクリップボードに仕様上アクセスができないため、日本語のTypeコマンドでのテキスト入力およびPasteコマンドを利用したコピー＆ペーストはできません。英語に関してはスクリーンキーボードの画像認識を利用し、リモート画面上に表示されたスクリーンキーボードを直接タップする形で文字入力を再現しています。

他のキーはスクリーンキーボードでシミュレートされます。この接続はユーザ操作として機能します。つまり、表示されているキーボードページを切り替え、個々のキー（文字）を画像認識を利用してタップする仕組みになっています。 英語スクリーンキーボードのみの対応です。英文字の入力にはTypeコマンドを使用します。

• Typeコマンドで入力する際にはキーボードを表示する必要があります。キーボードがオフのときに入力してもコマンドは無視されます。
• 現在サポートされているキーボードロケール（言語）は英語だけです。ロボットの処理中にキーボードを手動などで切り替えると、間違ったキーが入力されるため、切り替えを行わないでください。
  
• 接続は、現在のキーボードにあるキーだけをサポートします。複数キーマップを設定している場合は、ロボット動作前に標準キーボードに設定してください。
• 一部のキーは、デバイスがポートレートモードのときに使用できない場合があります。たとえば、iPhoneのキーボードの「キーボードを隠す」キーは、ポートレートモードで押すことはできません。このキーが横長のキーボードだけに含まれているからです。
• キーの長押しで表示されるリストにあるキーなどはサポートされません。
• 絵文字キーボードはサポートされていません。回避策は、キーボードを表示した状態でのMouse "click"コマンドなどを使用して手動でロボット化することです。
• 接続時の標準はSafariのキーボードマップです。アプリケーションによってキーボードレイアウトをカスタマイズしている場合は入力に失敗します。「XCode経由のiOS接続」対応プラグインのcom.tplan.iosx.LoadKeyboardとcom.tplan.iosx.RemapKeyboardスクリプトを使用してテストスクリプトから修正してください。

iOSキーボードキー （スクリーンキーボード）	スクリプトキー名称 （アクションの内容）	キー動作の説明
ENTER、GO	'Enter'（改行）	Enterキー。
DELETE（削除）	'Backspace'、'Delete'	バックスペースキー。挿入ポイントの前にある文字を削除します。
シフトキー	'Up'（上矢印）	シフトキーは、キーボードをシフトした文字（小文字=>大文字など）に切り替えます。 キーボードのページによってラベルや外観が変わります。 接続がそれ自身でスイッチを切り替えるので、シフト文字を入力するためにこのキーを手動で押す必要はありません。
キーの切替	'Right'（右矢印）	このキーは、キーボードを次のキーボードページに切り替えます。 キーボードのページによってラベルや外観が変わります。 接続によって別のページから文字が入力される場合、このキーを手動で押す必要はありません。
次のキーボード	'F5'	キーは次のキーボードロケールに切り替わります。 接続がSafari標準のロケールだけをサポート（マッピング）しているので、ロケールを切り替えるとType、Typelineコマンドが適用できなくなります。 その場合は手動でキーの入力ルーチンを作成する必要があります。入力支援を元に戻すには、基本キーボードロケールに戻す必要があります。
ディクテーション	'F6'	ディクテーションを開始します。

キーボードマッピング