Maestro 上手指南5 分钟跑通 Android、iOS 与 Web 的端到端测试【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro给安卓、iOS、Web 各写一套 UI 自动化维护三套选择器还要手动 sleep 等页面加载——这是不少团队做端到端测试时的日常。Maestro 是一个用 YAML 描述操作流程的移动端 UI 测试工具同一个 flow 文件可以跑在安卓模拟器、iOS 模拟器和浏览器上写完直接解释执行不用编译。一个跨平台 UI 测试的典型难题传统路线通常是这样安卓用 UIAutomator 或 EspressoiOS 用 XCUITestWeb 用 Selenium 或 Playwright。每套框架有自己的语言、API 和元素定位方式一次改版要在三处同步修改而页面加载时机不一靠固定延时等待的脚本就格外脆弱时过时挂。Maestro 的解决思路是把脚本降维成描述流程用 YAML 写成命令序列launchApp、tapOn、inputText、assertVisible就是全部核心词汇读起来接近自然语言解释执行引擎直接读 YAML 运行省掉编译环节改完立即生效见 maestro-orchestra 编排引擎源码每条命令内置自动等待元素没出现时引擎自己轮询不再需要手写 sleep一套流程覆盖安卓、iOS、React Native、Flutter 和混合应用Web 端通过 Chrome DevTools Protocol 驱动浏览器Maestro 安装步骤与启动方式前提是系统装有 Java 17 及以上版本。macOS、Linux 或 Windows WSL 下官方提供一行安装脚本直接装好 CLI如果本机已有源码也可以跳过安装直接maestro download-samples拉取官方样例工程含 flow 文件和应用安装包再对任意样例执行maestro test flow文件。仓库里自带一套 e2e 示例工程结构对新手很友好e2e/workspaces/wikipedia/下是安卓和 iOS 各两套 flowe2e/workspaces/web/是配静态页面的 Web 用例e2e/README.md 写明了启动模拟器和执行脚本的完整顺序。核心命令逐条演示先看仓库里的官方样例六行完成一次新建联系人appId声明被测应用后面每行一个命令从点击Create new contact到输入姓名、点Save顺序即执行顺序。自动等待替代 sleepassertVisible会持续检查元素是否出现动态加载的页面不用额外处理这是它抗时过时挂的关键条件分支runFlow配合when只在指定元素可见时执行子命令用来优雅地关掉不定时出现的弹窗可选步骤tapOn加optional: true后元素不存在也不报错适合处理偶发界面脚本注入runScript执行一段 JavaScript把返回值存进output后续命令用${output.result}引用例如随机生成搜索词再输入Web 用例有一个细节值得留意页面由本地 7357 端口的静态服务器提供e2e/README.md 解释了为什么要先跑e2e/ensure_fixtures再启动 flow否则launchApp会对着一个死端口成功报错信息却指向选择器。实战走查维基百科完整 flow打开 e2e/workspaces/wikipedia/android-advanced-flow.yaml能看到一个生产级用例的完整形态开头launchApp带clearState: true从全新状态启动应用避免上一次运行的残留数据干扰通过runFlow引入subflows/onboarding-android.yaml子流程连续点击引导页的下一步直到完成子流程用 ID 精确定位org.wikipedia:id/fragment_onboarding_forward_button两个when条件块分别处理年度回顾弹窗和已登出提示出现就点掉不出现就跳过runScript调 scripts/getSearchQuery.js 生成查询词inputText: ${output.result}填入后用assertVisible: ${output.result}断言搜索结果页真的出现了这套 flow 同时打上了ios、passing、advanced标签仓库的 e2e 机制会按标签断言每条用例的预期结果防止全部通过本身被误判。常见坑与适用边界装完跑不起来先查 Java 版本17 以下是高频原因Web flow 报Element not found而选择器明明正确多半是静态服务器没起先执行e2e/ensure_fixtures元素定位优先用可见文本其次才是 ID 和资源标识符ID 更稳定但绑定实现细节不想写 YAML 可以配合官方的 Maestro Studio 桌面端做可视化编写它是免费闭源产品不在本仓库内测试套件规模变大后官方另有 Maestro Cloud 提供并行执行属于商业化方向Maestro 的边界也清楚它面向 UI 层端到端验证不替代单元测试也不负责性能压测而一份 YAML 三端通跑正是它最省维护成本的地方。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考