mobile-next/mobilewright

何を解決するか

Mobilewright は、iOS および Android デバイスの自動化向けフレームワークで、Appium や Detox といった複雑な設定を置き換えることを目的としています。統一されたクロスプラットフォーム API を提供し、異なるモバイルオペレーティングシステム間で動作するテストや自動化スクリプトを、プラットフォーム固有のコードを毎回書かずに記述できるようにします。

動作方法

mobilecli を基盤として構築された Mobilewright は、Playwright をインスパイアしたアーキテクチャを採用しています。画面の座標やビジョンモデルに頼るのではなく、UI の決定論的で意味的な表現であるアクセシビリティツリーとやり取りすることで、タップ、テキスト入力、スワイプなどの操作を高い信頼性で実行できます。

ハイブリッドアプリの場合、WebView の DOM に接続して、ネイティブアプリ内に埋め込まれたウェブコンテンツに対して完全に Playwright 互換の Page API を提供できます。

対象ユーザー

• QAエンジニアおよび開発者：モバイル自動化において Playwright に似た開発体験を求める人。自動待機機能や意味的なロケータが内蔵されています。
• AIエージェント開発者：スマートフォンを制御するエージェントを開発している人。アクセシビリティツリーを公開しているため、スクリーンショットを処理するのではなく、トークン効率的で読みやすい意味的な操作でデバイスとやり取りできます。

特徴

• Playwright風API：getByRole や expect といった、馴染み深いメソッドで要素の発見とアサーションが可能。
• 自動待機：要素が表示され、有効で安定するまで自動的に待機してから操作を実行。
• クロスプラットフォーム：iOS および Android デバイス、シミュレータ、エミュレータに対して、同一の API を使用可能。
• AI対応：アクセシビリティツリーを通じて AI エージェントに最適化されたサポートを提供。ビジョンモデルの必要性を排除。
• ハイブリッドアプリ対応：ネイティブ自動化から WebViews 内のウェブ自動化へのシームレスな切り替え。
• ゼロ構成：起動中のシミュレータやエミュレータを自動で検出。