mobile-next/mobilewright

解决的问题

Mobilewright 简化了 iOS 和 Android 的移动设备自动化。它取代了像 Appium 或原生框架这样复杂且冗长的工具，提供了一个干净、自动等待的 API，减少了手动等待和复杂定位器（如 XPath）的需求，使编写可靠的测试和构建能够控制移动设备的 AI 代理变得更加容易。

运作方式

Mobilewright 建立在 mobilecli 之上，为与真实设备、模拟器和仿真器交互提供了统一的接口。它公开了设备的辅助功能树，允许用户通过语义角色、标签和文本而非坐标来查找元素。对于混合应用，它会桥接到 DOM 以提供与 Playwright 兼容的 Page 对象来处理网页内容。它还包含一个 doctor CLI 工具来验证 Xcode 和 Android SDK 等环境依赖项。

目标受众

• QA 工程师与开发者：希望在移动测试中获得类似 Playwright 开发体验的人员。
• AI 代理开发者：需要一种确定性、Token 高效的方式，让代理在不依赖视觉模型的情况下感知并与移动屏幕交互。
• 跨平台团队：需要单一 API 来同时针对 iOS 和 Android 进行开发的团队。

特色亮点

• 受 Playwright 启发的 API：使用熟悉的模式，如 getByRole、getByText 和 expect 断言。
• AI 就绪：提供对辅助功能树的直接访问，以实现确定性的代理控制。
• 自动等待：操作会自动等待元素变得可见、启用且稳定。
• 混合应用支持：使用标准 Playwright API 在原生视图和 WebViews 之间无缝切换。
• 跨平台：适用于 iOS 和 Android 设备及模拟器的统一接口。
• 零配置：自动发现已启动的模拟器。