前提条件
Mac 上
- macOS 10.15(Catalina)以降
- Xcode のインストール(最新バージョン推奨)
- Apple ID(無料版でも動作しますが制限があります)
- デバイス接続用の USB ケーブル
iOS デバイス上
- iOS 14.0 以降
- USB ケーブル接続
- デバイスのロックが解除され、信頼されている
初期デバイス接続
ステップ 1: デバイスを接続
- USB ケーブルで iOS デバイスを接続
- デバイスのロックを解除
ステップ 2: コンピューターを信頼
デバイスにプロンプトが表示されたら:- 「このコンピューターを信頼しますか?」ダイアログで信頼をタップ
- 求められた場合はデバイスのパスコードを入力
ステップ 3: Xcode で確認
- Xcode を開く
- Window > Devices and Simulators に移動
- デバイスがリストに表示されます
- ステータスが接続済みと表示されていることを確認
WebDriverAgent のセットアップ
WebDriverAgent(WDA)は iOS の自動化に必要です。Qaptly には、プロセスをガイドするセットアップウィザードが含まれています。WDA セットアップウィザードを開く
- Pilot Control を開く
- リストで iOS デバイスを見つける
- Setup WDA をクリック
- WDA セットアップウィザードが開きます
WDA セットアップフロー
ウィザードは 4 つのステップをガイドします:ステップ 1: WDA プロジェクトのダウンロード
- Download WDA をクリック
- WebDriverAgent プロジェクトが次の場所にダウンロードされます:
- または既存の WDA プロジェクトの場所を選択
ステップ 2: Xcode で署名を設定
- Open in Xcode をクリックして WDA プロジェクトを開く
- Xcode で、WebDriverAgentRunner ターゲットを選択
- Signing & Capabilities に移動
- Team(Apple ID)を選択
- 署名エラーを修正:
- 必要に応じて Bundle Identifier を変更(例:
.yournameを追加) - Xcode に自動的に署名を管理させる
- 必要に応じて Bundle Identifier を変更(例:
ステップ 3: Xcode で WDA を起動
- iOS デバイスをターゲットとして選択
- ⌘+U(Product > Test)を押して WDA をビルドして実行
- WDA がデバイスにインストールされて起動するまで待つ
- デバイスで開発者プロファイルを信頼する必要がある場合があります:
- 設定 > 一般 > デバイス管理に移動
- 開発者プロファイルを信頼
ステップ 4: ステータスを確認
- Qaptly に戻る
- Verify Status をクリック
- ステータスに「WDA Running」と表示されます
- セットアップが完了しました
WDA の使用
WDA の起動
WDA が実行されていない場合:- Xcode で WDA プロジェクトを開く
- デバイスを選択
- ⌘+U を押して WDA を起動
WDA の停止
- Xcode で Stop ボタンを押す
- または ⌘+. を押す
WDA ポート
WDA はデフォルトでポート 8100 で実行されます。Qaptly は自動的に WDA を検出して接続します。署名に関する考慮事項
無料の Apple ID
無料の Apple ID の場合:- アプリは 7 日後に期限切れになります
- 毎週 WDA を再インストールする必要があります
- 週に 3 つのアプリ ID に制限されます
有料の開発者アカウント
有料の Apple Developer アカウント(年間 99 ドル)の場合:- アプリは 1 年間有効です
- 毎週の再インストールは不要です
- より多くのアプリ ID スロット
エンタープライズアカウント
エンタープライズ証明書は次を提供します:- より長い有効期間
- より簡単な配布
- 開発用のデバイス制限なし
画面ストリーミング
ストリームの開始
- WDA が実行されていることを確認
- Pilot Control で iOS デバイスを選択
- Start Stream をクリック
- デバイスの画面がストリーミングパネルに表示されます
ストリーミング品質
iOS ストリーミングは Android と比較してわずかな遅延がある場合があります。これは WDA アーキテクチャのため正常です。複数の iOS デバイス
複数のデバイスの接続
- 各デバイスを USB で接続
- 各デバイスを信頼
- 各デバイスに WDA を設定
デバイスの選択
次の場所でターゲットデバイスを選択:- Xcode のスキームセレクター
- Pilot Control のデバイスリスト
トラブルシューティング
「Device Not Trusted」
- デバイスを切断して再接続
- プロンプトが表示されたら信頼をタップ
- 必要に応じてパスコードを入力
WDA ビルドが失敗
- コード署名設定を確認
- デバイスが接続されていることを確認
- ビルドフォルダをクリーン: Product > Clean Build Folder
- 再試行
「Unable to Launch WDA」
- デバイスのロックが解除されているか確認
- デバイスで開発者プロファイルが信頼されているか確認
- デバイスを再起動
- WDA のビルドを再試行
WDA が起動時にクラッシュ
- デバイスから WDA をアンインストール
- Xcode でビルドフォルダをクリーン
- 再ビルドして再インストール
デバイスが Pilot Control に表示されない
- デバイスが信頼されているか確認
- Xcode がデバイスを認識しているか確認
- USB 接続が安定しているか確認
- Pilot Control でデバイスリストを更新
「Profile Not Trusted」
iOS デバイスで:- 設定 > 一般 > VPN とデバイス管理に移動
- 開発者プロファイルを見つける
- 信頼をタップ
- 信頼アクションを確認
ベストプラクティス
- デバイスのロックを解除しておく: 自動ロックは WDA を中断する可能性があります
- パスコードを一時的に無効にする: 長時間のテストセッション用
- 高品質な USB ケーブルを使用: 粗悪なケーブルは接続問題を引き起こします
- Xcode を最新の状態に保つ: 最新の Xcode が最高のデバイスサポートを持っています
- Bundle ID の変更を文書化: 署名の変更を追跡
期限切れ後の再セットアップ
無料の Apple ID を使用している場合(7 日間の有効期限):- デバイスから WDA を削除
- Xcode でビルドフォルダをクリーン
- ⌘+U で WDA を再ビルド
- デバイスで新しいプロファイルを信頼