mobilewright

一套 API 搞定 iOS/Android 真机与模拟器自动化测试

开源 🏷️完全免费 ✅ 目前可打开 智能体 🍴 复刻 71 🐛 待处理 59 👀 关注 1
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 469
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源框架，Apache-2.0 许可证，完全免费，无付费版本。

项目预览

mobilewright 项目界面预览图
图片来源：项目官网

项目数据

分类智能体
开发团队mobile-next
官网地址https://mobilewright.dev
GitHubhttps://github.com/mobile-next/mobilewright
定价模式🏷️完全免费
价格说明开源框架，Apache-2.0 许可证，完全免费，无付费版本。
访问状态✅ 目前可打开
是否开源是
开源协议Apache-2.0
主要语言TypeScript
技术栈/模型ai,ai-agents,android,app,e2e-testing,end-to-end-testing,ios,mobilewright,playwright,real-device-automation,real-devices
GitHub 星标★ 469
上线时间2026-03-24 00:00:00
代码更新2026-11-01
仓库体积7.0 MB
本站数据更新2026-11-09
维护状态较活跃
收录时间2026-08-09
浏览次数1

项目介绍

Mobilewright 是一个面向移动应用测试与自动化的开发框架，基于 TypeScript 构建，提供统一的 API 来驱动 iOS 和 Android 应用在真机、模拟器及仿真器上运行端到端测试。它借鉴了 Playwright 的简洁设计理念，将移动设备控制、应用安装启动、UI 交互和断言能力封装成一套流畅的接口，解决了移动端自动化测试脚本难以跨平台复用、真机调试复杂等痛点。核心能力包括：通过单一 API 管理多设备会话、支持原生和混合应用、内置智能等待和自动重试机制、可与主流测试运行器（如 Jest、Mocha）集成，并能利用 AI 辅助生成测试步骤。项目处于早期阶段，但已具备完整的设备管理、截图、录屏和日志收集功能，适合作为移动端回归测试和 CI/CD 流水线中的自动化基础设施。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 469

使用教程

难度：进阶 约 25 分钟 部署方式：全局安装 4 步

环境要求

  • Node.js
  • 移动设备或模拟器

安装与启动步骤

  1. 1装包

    把框架装进项目。

    npm install mobilewright @mobilewright/test

  2. 2初始化

    生成配置与示例用例。

    npx mobilewright init

  3. 3跑诊断

    检查设备与驱动是否就绪。

    npx mobilewright doctor

  4. 4跑示例用例

    先在模拟器上验证。

    npx mobilewright test

如何确认成功

在模拟器上跑通示例用例，能完成一次点击与输入并断言结果

注意事项

  • 它把浏览器自动化的那套开发体验搬到移动设备上，写法对熟悉前端测试的人友好。
  • 先跑诊断命令，设备连接与驱动问题会在这里暴露。
  • 真机与模拟器的行为差异不小，关键用例两边都要跑。
  • 移动端的元素定位比网页脆弱，建议加等待与重试策略。

核心亮点

  • 统一 API 同时覆盖 iOS 和 Android，大幅降低跨平台测试脚本维护成本
  • 基于 Playwright 设计模式，上手快，支持智能等待和自动重试，减少 flaky 测试
  • 支持真机、模拟器和仿真器三种环境，灵活适配开发、测试和 CI 场景

不足之处

  • 早期项目，文档和社区生态尚不完善，遇到问题可参考资源有限
  • 对 AI 辅助测试的集成深度和稳定性有待验证，实际效果需进一步观察

适用场景

  • 移动应用回归测试：在 CI 中自动运行端到端用例，覆盖多设备兼容性
  • 跨平台开发团队：用同一套测试代码验证 iOS 和 Android 功能一致性
  • AI 辅助测试生成：结合大模型自动生成或修复移动端 UI 测试脚本

替代项目

Appium、Detox、Maestro

上一篇：awesome-n8n-templates

下一篇：skill-recorder

同类项目推荐

ai-website-cloner 开源

输入网址，AI 代理帮你克隆重建整个网站

AI website cloner for rebuilding live websites with AI coding agents

★ 155 2026-08-09
robotcode 开源

让 Robot Framework 拥有现代 IDE 体验，调试、补全、运行一气呵成。

Open Source Toolkit for Robot Framework, providing Language Server Protocol support,···

★ 307 2026-08-10
tampermonkey-scripts 开源

装上即用，AI聊天和论坛摸鱼效率翻倍

Greasemonkey、Tampermonkey scripts 油猴脚本集：AI chat全能助手、linux.do摸鱼...

★ 144 2026-08-09
ComfyUIMini 开源

手机上轻松跑 ComfyUI 工作流，随时随地出图

A mobile-friendly WebUI to run ComfyUI workflows.

★ 388 2026-08-09
mochi 开源

Bun 上的高保真隐身浏览器，稳定绕过指纹检测

The library for faithful browser automation. High-fidelity fingerprinting for Bun, e···

★ 220 2026-09-18
openchrome 开源

让 AI 直接操控你已登录的真实 Chrome

Open-source browser automation MCP server. Control your real Chrome from any AI agen···

★ 238 2026-09-18
writing-agent 开源

说个想法就成文，写作琐事全代劳

Writing Agent：开源多智能体对话写作助手。独立 Windows 客户端，无需 Claude Code，配置···

★ 453 2026-08-09
pi-warden 开源

给 Pi 代理加护栏，写文件守规则，假完成和死循环当场抓出

Guardrails for Pi that steer instead of interrupt: enforces your project rules on ev···

★ 178 2026-09-26
oh-my-taiyiforge 开源

把 Claude/Codex 接进编码流程，自动跑通生成到落地

AI workflow automation plugin for intelligent code generation with Claude/Codex

★ 853 2026-09-14