Maestro 移动 UI 测试实战指南5 分钟跑通第一个 E2E 用例【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro刚写完一个登录功能想确认它真的能用手动打开应用、填账号、点按钮、看页面——改十遍代码就够你手酸的。Maestro 是一个移动 UI 测试工具让你用 YAML 文件描述测试写launchApp、tapOn: Sign In、inputText: testexample.com三行命令在模拟器上自动执行最后告诉你结果是通过还是失败。 快速体验最短三步跑通先确认你的环境有 Java 17 及以上java -version验证然后启动一个 Android 模拟器或 iOS 模拟器curl -fsSL https://get.maestro.mobile.dev | bash maestro download-samples maestro test workspaces/wikipedia/android-flow.yaml第一步安装 Maestro CLI第二步下载官方的 Wikipedia 示例工程含 flow 和应用包第三步跑 Android 示例 flow。几分钟后终端会逐条打印每个步骤的执行结果全部通过则整体标记为成功。 核心场景拆解用 6 行 YAML 写一个回归用例解决什么问题每次验证功能都要在手机上点一遍慢、枯燥还容易漏步骤。关键配置把新建联系人这个手动动作写成 flow来自 README.md 的示例appId: com.android.contacts --- - launchApp - tapOn: Create new contact - tapOn: First Name - inputText: John - tapOn: Save你会看到什么终端按顺序执行并汇报任何一步失败时报告里会带上该步骤的 UI 层级和截图你能直接看出卡在哪一步。同一套写法测 Web 页面解决什么问题Web E2E 往往需要搭一整套工具链而现在你只需要再写一个 YAML。关键配置示例页面由本地静态服务器端口 7357提供先起服务再跑命令来自 e2e/README.mde2e/ensure_fixtures maestro --platform web test workspaces/web/date_input.yamlflow 内容见 date_input.yaml启动应用、点Date of birth、输入02111990。你会看到什么最后一条assertVisible: 1990-02-11确认页面把输入渲染成了完整日期整条用例通过。找不到元素 ID 时让 AI 来判断解决什么问题有些内容没有文本或 ID比如页面上的图是不是只有一只兔子传统断言写不出来。关键命令加一行自然语言断言即可- assertWithAI: assertion: A picture of a cute bunny is visible使用前需导出环境变量MAESTRO_CLOUD_API_KEY否则命令会报CloudApiKeyNotAvailable。模型支持见 maestro-ai 模块。你会看到什么Maestro 对当前屏幕截图发给模型判断断言成立则通过失败时会输出模型的判断理由。⚙️ 它是怎么做到的挑两个细节帮你理解为什么它不容易挂。智能等待找元素时默认超时是 17000msOrchestra.kt 里的lookupTimeoutMs。元素一时没出现它会持续盯着界面轮询直到出现或超时才判失败——像个老练的测试员盯着屏幕而不是手一抖就报红。所以 flow 里几乎不需要手写 sleep。解释执行 平台抽象YAML 被逐行解析成命令再由 Orchestra 按序分发给各平台的驱动maestro-client 下的AndroidDriver、IOSDriver、WebDriver。把它想象成提词器台词一行行念演员一行行演不用事先彩排编译。同一份 YAML 换平台跑差异都藏在驱动层。 进阶技巧与避坑问题Web 用例报Element not found但选择器明明正确。原因静态页服务没起Chrome 显示自己的错误页launchApp看起来却成功了。做法跑之前先执行e2e/ensure_fixtures它会等到服务器真正响应e2e/README 专门解释了这一坑。问题点击偶尔丢失用例随机失败。原因点击落在还没加载完的页面上被静默丢弃。做法用retry命令包裹maxRetries: 2仓库的 simple_web_view 示例就是这么写的。问题hideKeyboard失败。原因应用用了自定义输入框没有标准收起动作。做法改点一个非交互的静态文字元素来收起键盘源码的错误提示里直接给了这个方案。❓ 常见问题Q需要额外装 Node 或编译测试吗A不需要。flow 是解释执行的无编译步骤本地只需要 Java 17 和 Maestro CLI。Q一份 flow 能同时跑 Android 和 iOS 吗A可以。示例目录 e2e/workspaces/wikipedia/ 里android-flow.yaml和ios-flow.yaml并存命令基本一致平台差异由驱动层吸收。Q它和 Appium、Espresso 比定位在哪 AMaestro 定位在跨平台、少维护一套 YAML 同时覆盖 Android、iOS 和 WebReact Native、Flutter 等混合应用也可测内置等待机制减少偶发失败。一句话总结Maestro 把写移动端 E2E 测试变成写几行 YAML 步骤维护成本接近文本文件。想深入就看 README.md 的 Getting Started 章节它把安装应用、跑示例 flow 讲得比本文更细遇到 bug先按 CONTRIBUTING.md 的格式打开一个新 Issue附带上失败时的截图和 flow 文件。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考