mobile-next/mobilewright

解決的問題

Mobilewright 是一個用於自動化移動設備（iOS 與 Android）的框架，旨在取代 Appium 或 Detox 等複雜設定。它提供統一的跨平台 API，讓開發者能撰寫可在不同行動作業系統上運作的測試或自動化指令碼，而無需為每個動作撰寫平台特定的程式碼。

工作原理

基於 mobilecli 建構，Mobilewright 採用 Playwright 為靈感的架構。它不依賴原始座標或視覺模型，而是與裝置的可存取性樹（UI 的決定性、語意化表示）互動，從而以高可靠性執行點擊、輸入文字、滑動等操作。

對於混合式應用，它可接入 WebView 的 DOM，為嵌入在原生應用中的網頁內容提供完整的 Playwright 相容 Page API。

適用對象

• QA 工程師與開發者：希望在移動自動化中獲得類似 Playwright 的開發體驗，內建自動等待與語意定位器。
• AI Agent 開發者：需要控制手機的代理開發者。由於公開可存取性樹，代理可使用高效、易讀的語意化操作與裝置互動，而非處理螢幕截圖。

特色亮點

• Playwright 風格 API：使用熟悉的 getByRole 與 expect 等方法進行元素發現與斷言。
• 自動等待：操作會自動等待元素可見、啟用且穩定後才進行互動。
• 跨平台：一套 API 可同時適用於 iOS 與 Android 裝置、模擬器與模擬器。
• AI 就緒：透過可存取性樹提供對 AI Agent 的第一級支援，無需依賴視覺模型。
• 混合式應用支援：可無縫從原生自動化切換至 WebViews 內的 Web 自動化。
• 零設定：自動發現已啟動的模擬器與模擬器。