Maestro｜YAML移动E2E测试，一次编写跨平台运行

MaestroYAML移动E2E测试一次编写跨平台运行【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/MaestroMaestro 是一个开源的移动 E2E 测试框架用人类可读的 YAML 描述 UI 操作与断言同一份测试流可在 Android、iOS 与 Web 上执行不需要编写测试代码。项目速写覆盖 Android、iOS、Web 三端YAML 编写用例解释执行、无需编译内置智能等待与重试容忍动态 UI模拟器、模拟器或真机均可运行单脚本安装配套可视化 Studio跑起来前置条件Java 17一个已启动的模拟器或 ADB 连接的设备。git clone https://gitcode.com/GitHub_Trending/ma/maestro cd maestro ./installLocally.sh maestro test e2e/workspaces/wikipedia/android-flow.yaml预期结果终端逐条打印命令执行状态全部 PASS 后流程结束没有可用设备时会直接提示连接设备。仓库e2e/workspaces/下还附带了 Wikipedia、Web 等多组可直接运行的示例流。核心机制拆解YAML 流程引擎输入 → 处理 → 输出输入一个 flow 文件头部声明appId正文是launchApp、tapOn、assertVisible等命令列表。处理MaestroFlowParser.kt 把 YAML 解析成命令对象Orchestra.kt 按序执行每个需要定位元素的命令都会由 Filters 生成匹配条件文本、id、属性在设备端反复轮询元素元素没出现就自动等待这就是不需要手写sleep()的原因。输出逐条 PASS/FAIL 结果、失败截图与报告退出码可用于 CI 判断。跨平台 Driver 层同一套命令通过 Driver.kt 抽象下发Android 端走 ADB 拉起设备内的 agentiOS 端经 XCTest 驱动Web 端接 Chrome DevTools Protocol。对写用例的人而言三端语法完全一致差异只在appId和执行目标。一个完整工作流以启动应用并验证首页元素为例启动模拟器adb devices确认设备在线。新建 flow 文件launchApp启动应用tapOn: 搜索框点击控件assertVisible: 首页断言结果。maestro test flow.yaml执行观察终端逐条输出。定位失败时用maestro hierarchy打印当前视图树按实际文本修正选择器。把 flow 提交到仓库换一台 iOS 设备后只替换appId即可复用。容易踩的坑现象tapOn报找不到元素。原因控件尚未渲染或屏幕文本与预期不完全一致。解法在操作前加assertVisible等待元素再用maestro hierarchy核对真实文本。现象命令卡住或提示无设备。原因模拟器未启动或 ADB 未授权。解法先执行adb devices确认输出包含device状态再重跑。现象Android 上通过的 flow 在 iOS 上失败。原因appId是 Android 包名。解法按平台拆分 flow 文件参考仓库中 wikipedia 的 android-flow.yaml 与 ios-flow.yaml 的写法。收尾Maestro 的价值在于把 E2E 测试从写代码降到写清单YAML 即用例引擎负责等待、重试与三端适配。想深入实现可以从 执行引擎 Orchestra.kt 和 驱动接口 Driver.kt 两个入口读起。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考