Maestro 移动UI自动化测试完整手册从安装到用例复用的 5 步实践指南【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/MaestroMaestro 是一款开源的移动UI自动化测试工具你用 YAML 文件描述操作步骤它就能驱动 Android、iOS 和 Web 应用跑完整个端到端流程。它解决的核心问题是同一份流程文件可以跑在模拟器、真机和浏览器上不必为每个平台维护一套测试代码。读完这篇指南你能够完成 Maestro 安装写出第一个测试脚本并把单个脚本扩展成可复用、双端兼容的用例工程。移动UI自动化测试的痛点多机型回归为什么这么贵你一定遇到过这种局面登录流程在 Android 上有一套 EspressoiOS 上另写一套 XCUITestWeb 端还得再搭一套 Playwright。三套代码、三种 API每多一个机型或系统版本回归就要多跑一轮。问题出在测试代码紧贴平台 API平台一变脚本全得改。Maestro 的取舍是把这层抽象成一份 YAMLtapOn、inputText、assertVisible 这类命令接近自然语言执行引擎负责等待元素出现、容忍界面抖动。你维护的变成业务流程本身而不是某个平台的控件调用。Maestro 安装最快安装方式五分钟跑起第一个测试前置条件只有一个JDK 17 以上脚本会自动检查 unzip 和 curl 是否可用。git clone https://gitcode.com/GitHub_Trending/ma/maestro cd maestro ./scripts/install.sh maestro --version安装脚本把二进制放进~/.maestro/bin并写入 PATH。如果当前终端提示找不到命令直接开一个新终端即可。接着写第一个脚本保存为login.yaml把 appId 换成你自己的应用包名appId: com.example.app --- - launchApp - tapOn: Login - inputText: userexample.com - assertVisible: Welcome运行maestro test login.yaml就能看到完整执行过程。每个命令执行后引擎会自动等待下一步的目标出现所以多数场景不需要手写 sleep。Maestro 元素定位与稳定性技巧从能跑到跑得稳元素定位有几个常用维度tapOn可以直接给文本也可以用id指定 resource-id / accessibility id或者用正则、坐标和index第 n 个匹配项。实践建议是优先用id而不是文案——文案随语言包变化id 相对固定断言assertVisible同理。控制稳定性的两个参数值得记住timeout给单步等待设上限慢一点的网络加载就不会误报失败retry对不稳定的步骤整体重试 N 次直到内部的断言通过。- retry: times: 3 until: - assertVisible: Home另外when子句支持按platformandroid/ios/web或环境变量分支让你在一个文件里区分不同系统的行为。把用例工程化runFlow 复用与 Android/iOS 双端适配登录逻辑几乎每条用例都要用重复写三遍之后维护成本就来了。正确做法是把它抽成login.yaml通过runFlow加variables传入参数子流程里用${username}这样的占位符引用- runFlow: file: login.yaml variables: username: test password: 123456文件头部声明variables即可提供默认值外部不传就用默认传了就覆盖。双端适配的思路相同把差异步骤拆进ios_steps.yaml和android_steps.yaml主流程里用when: platform: ios路由到对应子流程。仓库里 e2e/workspaces/ 目录下有大量现成 YAMLwikipedia子目录就是一个双端分离流程的完整例子照着改比从零写快得多。进阶玩法runScript 扩展与 MCP 接入 AI两个进阶方向这里只点到为止。runScript允许在流程里执行一段 JavaScript 并读取返回的 JSON适合断言逻辑复杂到 YAML 表达不动的场景实现在 maestro-client/ 的 js 模块里基于 GraalVM 的 JS 引擎。另一个是 MCPModel Context Protocol接入Maestro 把设备管理、界面读取、流程执行都暴露成 MCP 工具LLM 代理可以直接驱动设备、甚至生成并运行 flow 文件。运行maestro mcp即可启动服务完整实现和说明在 maestro-cli/src/main/java/maestro/cli/mcp/ 目录。用得上时再深入即可。常见问题速查FAQ现象可能原因处理方式安装后提示找不到 maestro 命令PATH 未刷新新开终端或手动export PATH$PATH:$HOME/.maestro/bin运行时找不到设备模拟器/仿真器未启动先启动设备再用maestro status确认连接报 Element not found元素出现慢或定位不稳定加timeout或包一层retry定位优先用id不确定元素怎么找对界面结构不熟悉运行maestro hierarchy导出当前 XML查看可用属性总结最短路径是装好 CLI把示例 flow 的 appId 换成自己的跑通第一条断言再逐步加上 retry、runFlow 和平台分支。官方示例都放在 e2e/workspaces/配合 maestro-cli/ 里的源码足够你把移动UI自动化测试从能跑推进到能维护。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考