5分钟跑通Maestro移动UI自动化测试新手实战指南【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro每次发版前你都要手动打开应用走一遍登录、下单、校验结果的流程。单平台五分钟能忍三个平台轮流点就熬人了。Maestro 是一个开源的移动 UI 自动化测试框架用 YAML 流程文件在 Android、iOS 和 Web 上跑端到端E2E测试第一个用例大约五分钟就能写出来模拟器、仿真器和浏览器都能执行。它是什么一句话说清解决的问题Maestro 用人类可读的 YAML 语法加解释型执行引擎让你不编译就能写跨平台的 E2E 测试覆盖 Android、iOS 和 Web含 React Native、Flutter、混合应用。它的设计参考了 Appium、Espresso、UIAutomator、XCTest、Selenium、Playwright 这些框架的经验把等待、重试、截图这类脏活统一收进了引擎里。核心优势当你需要一份用例覆盖多平台时用同一份 YAML 流程加--platform参数切换目标得到一套用例跑三种环境。当你需要处理动态加载的界面时用内置的元素等待与重试机制得到不用手写sleep()的稳定流程。当你需要验证页面状态时用assertVisible这类断言命令得到明确的通过/失败结果和失败现场截图。当你需要快速试错时用解释型执行方式改完即跑得到秒级的迭代反馈。5分钟跑起来安装与首次运行准备环境与安装依赖只有一个Java 17 或更高版本用java -version确认。然后在 macOS、Linux 或 WindowsWSL上运行官方脚本curl -fsSL https://get.maestro.mobile.dev | bash装完得到maestro命令。仓库本身是 Gradle 工程如果你要改源码./gradlew build即可。编写最小可用流程新建flow_contacts_android.yaml测试系统通讯录appId: com.android.contacts --- - launchApp - tapOn: Create new contact - tapOn: First Name - inputText: John - tapOn: Last Name - inputText: Snow - tapOn: Save文件头部声明应用包名正文每一行是一个动作启动、点击、输入文本。没有导入、没有初始化写什么执行什么。确认跑通执行maestro test flow_contacts_android.yaml。所有步骤通过后终端输出绿色 Passed 汇总并生成包含每步截图的报告。如果手边没有合适的目标应用可以先运行maestro download-samples拉取官方示例流程与应用包照着跑一遍再回头改自己的用例。核心能力拆解定位、断言与子流程元素定位与断言适用场景日常流程里的绝大多数步骤。定位方式从文本、资源 ID 到组合条件断言覆盖可见性与消失- tapOn: 登录 # 按文本定位 - tapOn: id: com.example:id/login_btn # 按资源 ID 定位 - inputText: testdemo.com - assertVisible: 首页 - assertNotVisible: 加载中...文本定位对 UI 文案改动敏感关键路径建议用idassertVisible会在超时前持续轮询元素出现即通过不需要你提前判断页面加载完没有。子流程与变量注入适用场景登录、环境准备等步骤被多个流程复用或同一流程要跑多组账号。- runFlow: subflows/login.yaml env: USERNAME: testuser1 - runScript: scripts/getSearchQuery.js - inputText: ${output.result}runFlow调用另一个 YAML 并通过env注入变量runScript执行 JavaScript 脚本脚本输出经${output.result}引用数据驱动用例由此实现。等待与留痕适用场景页面有动画、滚动惯性或失败时需要证据。引擎在每次点击后会等待界面稳定滚动结束后自动处理减速惯性显式命令还有waitForAnimationToEnd、takeScreenshot和屏幕录制失败时报告里保留截图与日志。上图是录制功能使用的背景画面。除 YAML 手写外Maestro 也提供maestro record把你在设备上的操作录成流程文件再人工整理即可。实战走通跑一个真实的维基百科流程仓库自带对 Wikipedia 应用的完整测试位于 e2e/workspaces/wikipedia/按输入→操作→结果看一遍输入模拟器安装 Wikipedia流程文件android-advanced-flow.yaml以及一个生成随机搜索词的 JS 脚本。操作先runFlow调用子流程以clearState: true冷启动并点掉新手引导再点击搜索入口按id定位然后runScript取随机词并输入。结果assertVisible: ${output.result}断言搜索结果可见流程通过同一工作区有ios-flow.yaml换平台参数即可跑对应版本。appId: org.wikipedia --- - runFlow: subflows/onboarding-android.yaml - tapOn: id: org.wikipedia:id/search_container - runScript: scripts/getSearchQuery.js - inputText: ${output.result} - assertVisible: ${output.result}底层视角架构与关键模块仓库按职责拆成多个 Gradle 模块maestro-cli命令行入口test、record、query等子命令都在maestro-cli/src/main/java/maestro/cli/command/下。maestro-orchestra-modelsYAML 命令的数据模型每条命令一个类。maestro-orchestra流程解析与执行引擎负责编排命令、变量与子流程。maestro-client跨平台执行核心Maestro类封装定位、点击、等待、截图背后是统一的Driver接口。maestro-android / maestro-ios / CdpWebDriver三个平台的 Driver 实现iOS 另有一个独立的 XCUItest 运行器maestro-ios-driver。命令模型长这样maestro-orchestra-models/ 下的MaestroCommand.ktdata class MaestroCommand( val tapOnElement: TapOnElementCommand? null, val scrollCommand: ScrollCommand? null, val assertConditionCommand: AssertConditionCommand? null, // ...约50种命令类型 )YAML 的每行被反序列化为其中一个字段执行引擎按字段分发这就是人类可读语法背后的映射方式。规模化使用协作与 CI 接入流程文件就是普通文本放进版本库即可共享。仓库自身的 e2e 套件给出了团队用法每个流程用tags标注android、passing、web等标签CI 用--tags只跑指定子集e2e/run_tests脚本批量执行并按标签核对应该过还是应该挂防止测试永远变绿的假象。Web 流程由e2e/ensure_fixtures启动一个静态服务器提供测试页面配合--platform web执行。接入 CI 很直接在流水线里安装 CLI运行maestro test flows目录失败时非零退出码阻断合并报告产物归档到流水线日志。测试套件变大后官方提供 Cloud 做并行执行、Studio 做可视化编辑均不在这个开源仓库内。学习路径文档、示例与社区官方文档站提供安装、写流程、CI 集成的完整章节README.md里有入口链接。e2e/README.md 讲清楚了示例套件、Web 静态服务器和预期失败标签的约定值得先读。e2e/workspaces/ 下有 wikipedia、web 等真实流程每个目录都附配套脚本改参数即可复跑。社区通过 Slack 支持贡献入口见 CONTRIBUTING.md。行动清单安装 CLI用通讯录示例或download-samples把第一个流程跑绿。给自家应用写一个冒烟流程启动、登录、断言首页关键元素。把重复步骤抽成subflows用env变量区分账号和环境。把流程目录接入 CI失败阻断合并报告归档。遇到怪异的偶发失败去 maestro-orchestra 里看等待与重试的实现再决定是调参还是补waitForAnimationToEnd。第一条跑绿之后你可以按团队发版节奏逐步把手工回归清单一条条迁进 YAML 里。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
)
)
