10分钟跑通第一条移动端E2E测试Maestro UI自动化测试从安装到实战【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro发版前总得把主流程在模拟器上手动点一遍——登录、填表单、核对结果一天两次还好版本节奏一快又慢又容易漏。这类重复劳动可以写成文件交给工具执行Maestro 是一个开源的移动端 UI 自动化测试框架测试步骤用人类可读的 YAML 写成同一套语法能跑在 Android、iOS 和 Web 上流程是解释执行的、不用编译还自带自动等待机制大多数场景不需要你手写一行 sleep。YAML 流程文件和代码一起进仓库团队里任何人都能读懂失败时直接定位到哪一步、当时是什么界面。读完这篇你可以从零装好 Maestro、写出一条登录流程并一次跑通再遇到 CI 里偶发的失败也知道该往哪查。装好并跑通第一条命令Maestro 依赖 Java 17 及以上版本先在终端确认环境java -version看到版本号在 17 及以上就可以继续不满足就先装 JDK 17后面的步骤都建立在它之上。确认无误后macOS、Linux 和 WindowsWSL都用这一条命令安装curl -fsSL https://get.maestro.mobile.dev | bash脚本会把最新版 Maestro 放进~/.maestro/bin并配置 PATH。装完打开一个新的终端敲maestro看到帮助信息含 test、studio 等子命令说明就算成功。如果提示 command not found说明当前终端还没加载新的 PATH开个新终端再试即可。核心命令速查日常流程里出现频率最高的就下面这几个形式都是「命令: 参数」命令作用最小示例launchApp启动被测应用web 平台配url字段- launchApptapOn点击元素按文本或 id 定位- tapOn: LogininputText向当前聚焦的输入框写入文本- inputText: helloassertVisible断言元素可见支持正则- assertVisible: .*welcome.*assertNotVisible断言元素不存在- assertNotVisible: Errorswipe滑动屏幕露出视口外的内容- swipe: direction: UPrunFlow引用子流程拆分管线- runFlow: login.yaml组合起来就是这样一段最小可用的流程- launchApp - tapOn: Username - inputText: standard_user - tapOn: Login - assertVisible: Products手把手写一条完整的登录流程以 Web 登录为例这是最经典的场景。在终端进入工作目录新建login_flow.yaml内容如下url: https://www.saucedemo.com/ tags: - web - login --- - launchApp - tapOn: Username - inputText: standard_user - tapOn: Password - inputText: secret_sauce - tapOn: Login - assertVisible: Products - assertVisible: Sauce Labs Backpack开头两个字段决定跑在哪个目标上web 平台用url指定入口页面移动端则换成appId填包名比如appId: org.wikipedia。tags不参与执行是给流程打标签方便在 CI 里按标签筛一批用例。前六步是纯操作。每一步执行前都会自动等待目标元素出现tapOn找到 Username 才点inputText写入当前聚焦的输入框——全程没有 sleep这是 Maestro 和手写 Appium 脚本最大的区别。最后两行断言才是测试真正验证的内容商品列表出现、且能看到具体商品才算登录通过只操作不断言的流程等于没测。在终端执行maestro test login_flow.yaml预期输出每步打勾最后一行Flow passed退出码为 0每步的截图会存在maestro-test/目录里失败时直接拿来对照。进阶技巧 跑通之后下面几个写法值得养成习惯。optional 断言——你会遇到某些弹窗偶尔出现缺席时流程卡死在这一步。这么解决给步骤加optional: true元素不存在时该步直接跳过。- tapOn: text: Close optional: trueclearState 干净开局——你会遇到首次启动的引导页、上一次运行的残留状态干扰下一条用例。这么解决启动时清数据保证每次都从干净状态开始。- launchApp: clearState: true环境变量——你会遇到测试环境和正式环境账号不同不想维护两份流程。这么解决用${VAR}读环境变量跑之前由外部注入不同值。- inputText: ${ACCOUNT} - assertTrue: ${ACCOUNT standard_user}runFlow 拆子流程——你会遇到多条用例共享同一段登录、onboarding 前缀。这么解决抽成独立 yaml 再引用前四个技巧在 wikipedia 进阶流程 里都有完整示范。- runFlow: subflows/login.yaml高频问题排查⚠️ 下面五个是翻车率最高的问题按症状对号入座。maestro: command not found→ 原因安装脚本把 PATH 写进了 shell 配置当前终端没重新加载。解法开新终端或执行export PATH$PATH:$HOME/.maestro/bin。tapOn报 Element not found但元素明明在屏幕上→ 原因文本和屏幕上不一致大小写、空格或元素藏在 WebView 里。解法用 Maestro Studio 的 inspector 查看元素真实属性改按id定位或写正则text: .*Login.*。本地稳定通过CI 上偶发失败→ 原因CI 模拟器慢首屏渲染晚撞上等待超时。解法关键步骤前加一个稳定锚点元素的assertVisible已知不稳定的断言挂optional: true。提示找不到设备→ 原因模拟器没启动或 adb 不在 PATH。解法adb devices确认状态是device没启动就先emulator -avd 镜像名把模拟器拉起来。web 流程launchApp通过、后续元素全找不到→ 原因目标服务没就绪浏览器显示的是错误页。解法先确认目标服务已启动再在launchApp后紧跟一个关键元素的断言。工具链与延伸命令行用熟之后可以换 Maestro Studio它是免费的桌面 IDE支持鼠标录制操作、直接检查屏幕元素属性不用肉眼猜元素文本。更多能直接抄的场景看仓库里的 web 流程集每个文件都是可跑通的独立用例。查具体命令参数去官方文档 docs.maestro.dev社区交流走官方 Slack。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考