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 自动化。
• 零配置：自动发现已启动的模拟器和模拟器。