Maestro 入门实践用 YAML 给 Android、iOS 与 Web 写自动化 UI 测试【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro每天早上开工同一套回归流程要在 Android 模拟器、iOS 仿真器上各手点一遍改个按钮文案还要担心漏了哪台机器。Maestro 是一个开源的移动 UI 自动化框架用 YAML 文件描述点击、输入、断言等操作一条命令就能在 Android、iOS 和浏览器上跑完这套流程无需为每个平台各写一套脚本。先判断它适不适合你Maestro 的定位是 UI 层面的端到端测试适合 App 验收、发布前回归以及需要跨 Android、iOS、Web 三端复用同一份用例的团队。它不适合替代单元测试、纯接口测试和性能压测——这些场景用各自的专用工具更合适。如果你的测试主要停留在调完接口看一眼返回值引入 UI 自动化只会增加维护成本。装好并跑通第一个用例环境要求只有一项本机装有 Java 17 及以上版本可用java -version确认。安装是单条命令脚本会把二进制下载到~/.maestro并写好 PATH脚本源码见 scripts/install.sh官方安装地址以仓库根目录 README 为准java -version curl -fsSL https://get.maestro.mobile.dev | bash第一条用例不必从自己的 App 开始。Android 自带的 Contacts 应用就够用新建一个 YAML 文件声明目标应用的 appId然后是一串动作——启动、点击、输入、再断言全程没有代码也不需要编译appId: com.android.contacts --- - launchApp - tapOn: Create new contact - tapOn: First Name - inputText: John - tapOn: Save - assertVisible: John运行只需一条命令maestro test flow_contacts.yaml执行结束时终端会逐步打印每条命令的结果最后给出 PASS 或 FAIL失败时附截图和元素树方便定位是哪一步没点中。把用例写稳同名元素点不准界面里出现多个同文案按钮时tapOn: 确定会随机命中。优先改用元素 ID 定位或者给条件对象加index指定第几个匹配enabled、textMatches等限定条件组合起来基本能覆盖定位歧义问题。动画和加载让断言抖动不要靠sleep硬等它要么等太久拖慢套件要么等不够照样挂。Maestro 的元素查找本身就带自动重试assertVisible写下来就等于等到它出现再判断遇到转场动画加一行waitForAnimationToEnd再配合assertNotVisible等加载提示消失比任何拍脑袋的等待时间都可靠。一份用例跑多组账号账号、环境地址这类变量别写死在用例里。流程头部的env块和运行时的--env参数可以注入值用例中用{{VAR}}占位子流程用runFlow调用时同样支持传 env。同一份登录流程生产账号和测试账号各跑一遍就不需要复制两份文件了。从单机到团队用例多了以后升级路径大致是三步。个人写用例阶段可以换 Maestro Studio 这个免费桌面 IDE可视化搭流程、检查器里直接点选元素拿定位条件、录制操作生成 YAML省去手写细节——注意它是闭源独立应用代码不在这个仓库里。团队规模上云之后Maestro Cloud 把用例分发到专用基础设施并行执行官方数据称执行时间可缩短约九成并附带完整报告。接入 CI 没有门槛GitHub Actions 里安装脚本加maestro test ./tests/两行就是一条流水线再给 YAML 打上 tag仓库 e2e/workspaces/ 里的示例都带 tag如passing、web就能按 tag 筛选用例控制每次构建跑多少。源码地图仓库是多模块 Kotlin 工程职责划分清楚maestro-cli/是命令行入口负责设备发现、执行调度和报告maestro-client/抽象出Driver、Maestro等核心接口Android、iOS、WebCDP三个驱动各自实现maestro-orchestra/是解释执行引擎从Orchestra.kt开始读文件、逐条执行命令、收集失败产物maestro-orchestra-models/定义 YAML 命令模型Commands.kt和ElementSelector.kt是理解全部命令和定位语法的入口maestro-ios-xctest-runner/则是一整个 Swift 的 XCTest Runner 工程。想动手改之前先读Orchestra.kt的执行循环和ElementSelector.kt再对照 CONTRIBUTING.md 的协作约定即可。用例文件是仓库里最便宜的学习材料e2e/workspaces/ 目录下的示例覆盖了 Web、iframe、SPA 导航等场景比任何教程都贴近真实写法。等你需要多设备并行、可视化编写和统一报告时再依次引入 Studio 与 Cloud 就好。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考