WDA-Runner：iPhone向けUI自動化テストツール

概要

WDA-Runnerは、iPhoneのUI自動化テストをローカルネットワーク内で実現するShellスクリプトベースのツールで、iOS端末内にサーバーを立ち上げ、PCのブラウザからアクセスして操作やテストを行えます。iOSの署名が必要なIPAファイルに対して独自の署名スクリプト（resign.sh）を用意しており、Mac環境での利用を前提にしています。試用版は1分間の制限付きで、製品版はライセンス認証が必要になるため、用途や環境に応じた適切な活用が可能です。

リポジトリの統計情報

スター数: 4
フォーク数: 0
ウォッチャー数: 4
コミット数: 6
ファイル数: 7
メインの言語: Shell

主な特徴

iPhone内部にWebDriverAgent（WDA）ベースのサーバーを起動し、ローカルネットワークから操作可能
IPAファイルの署名を支援するresign.shスクリプトを同梱（Mac限定）
試用版は1分間の利用制限あり、製品版はライセンス認証が必要
不正利用禁止の明記と署名・インストールに関する詳細な手順をREADMEで解説

技術的なポイント

WDA-RunnerはAppleのWebDriverAgent（WDA）をベースに、iPhoneのUI自動化をローカルネットワーク経由で行うための環境構築を支援するツールです。WDAはiOSのUI操作を自動化する標準的な手法ですが、セットアップや署名が複雑で初心者にはハードルが高いのが現状です。本リポジトリはそこを補完するため、Shellスクリプト主体で簡単にWDA環境を起動・制御できる仕組みを提供しています。

特に重要なのがIPAファイルの署名プロセスです。Appleのセキュリティ上、署名されていないIPAは端末にインストールできず、また、一般的な署名ツールは動作が不安定なことが多いです。そこでWDA-Runnerは独自のresign.shスクリプトを提供しており、これを使うことで署名が安定し、Mac環境であれば簡単に署名済みアプリを生成可能です。署名スクリプトはユーザーの環境に合わせてキーチェーンの名前やプロビジョニングプロファイルを設定できる柔軟性を持ち、実際には説明文にあるように「鍵束」と「プロファイル」の管理さえできれば、比較的容易に利用可能です。

さらに、WDA-RunnerはiPhone端末内に小型のサーバーを立ち上げ、同じLAN内のPCブラウザからHTTP経由でアクセスする方式を採用しています。これにより、物理的な接続がなくともネットワーク経由でUIテストを制御でき、柔軟なテスト環境の構築を可能にしています。ブラウザでのアクセスはテストの自動化だけでなく、手動操作や確認にも使え、活用の幅が広い点が魅力です。

ただし、現状は試用版が1分間のサービス制限付きであり、継続的な利用には正規のライセンスが必要です。また、本ツールは不正利用を厳しく禁止しているため、用途や法令順守には十分な注意が求められます。署名関連の知識やMac環境の準備が前提となるため、一定の技術知識は必要ですが、iOS UI自動化の敷居を下げる点で非常に有用なツールと言えます。

プロジェクトの構成

主要なファイルとディレクトリ：

1111.png: 使用例や画面イメージの画像ファイル
2222.jpeg: 関連するスクリーンショット等の画像
3333.png: UIや設定画面などの補助画像
LICENSE: ライセンスファイル
README.md: インストール方法や使い方、署名手順を詳細に説明
resign.sh: IPAファイルの署名を行うShellスクリプト
その他Shellスクリプトや設定ファイル

まとめ

iOS UI自動化の導入を効率化する実用的ツール。

リポジトリ情報：

名前: WDA-Runner
説明: UI自动化测试/局域网内控制iPhone测试
スター数: 4
言語: Shell
URL: https://github.com/ado2023-oss/WDA-Runner
オーナー: ado2023-oss
アバター: https://avatars.githubusercontent.com/u/228270021?v=4