MaestroYAML 驱动的移动端 UI 自动化测试——一条登录回归不用写任何代码框架【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro你刚改完登录页的按钮交互想确认整条登录流程没被改坏又不想等单元测试之外的任何东西。Maestro 是一个开源的移动端 UI 自动化测试框架用人类可读的 YAML 写流程再在 Android 模拟器、iOS 模拟器或浏览器上直接执行。本文带你从零把本地环境跑通并演示一条电商登录回归的完整工作流。 5 分钟跑通本地环境前置条件只有一个Java 17 及以上java -version确认即可。在仓库内构建并运行一条示例流程git clone https://gitcode.com/GitHub_Trending/ma/maestro cd maestro ./maestro --platform web test e2e/workspaces/web/simple.yaml./maestro是仓库根目录的包装脚本会自动执行 Gradle 构建maestro-cli模块并启动 CLI首次构建需要几分钟。流程访问的是公开站点 saucedemo.com不需要本地起服务。成功信号终端逐条打印launchApp、tapOn、inputText、assertVisible及各自耗时最后一行汇总 PASSED。如果看到 FAIL对照终端里的失败步骤名排查。 核心能力拆解一套命令覆盖 Android、iOS 与 Web同一个团队维护三套测试脚本是常见的负担。Maestro 把交互抽象成平台无关的命令你在流程里只写tapOn: Login、inputText: secret_sauce引擎按目标平台把命令翻译到对应的底层驱动——Android 走 UIAutomator、iOS 走 XCUITest、Web 走 Chrome DevTools 或 Selenium对应代码分别在 Android 驱动、iOS 驱动 与 Web 驱动。使用边界入口参数按平台不同launchApp在 Android/iOS 用appId、在 Web 用url在流程头部声明一次即可。YAML 流程编排与子流程复用多步回归里启动应用、跳过引导页这类步骤会反复出现手写多遍很难维护。YAML 流程本质是一个有序命令列表subFlow可以把公共片段抽成独立文件按相对路径引用多个主流程共享同一段 onboarding 逻辑。仓库的 e2e 目录本身就是范例Wikipedia 测试工作区 用subFlow复用 launch-clearstate-android.yaml 等片段按 Android/iOS 分目录组织。注意子流程继承的是相对路径解析文件挪动后先跑一遍checkSyntax更稳妥。智能等待与失败取证动态 UI 场景下手动sleep()要么等太久要么根本不够偶发失败又难以复现。每条命令执行前引擎会自动轮询目标元素等到出现或超时为止你也可以用waitFor显式指定等待条件与时长自 2.7.0 起每个步骤执行前会自动截图失败时把该步截图和视图层级一并打进调试产物目录配合maestro hierarchy打印的层级 JSON 即可离线分析不必反复重跑。定位问题时优先看调试目录里的截图和层级文件。 一个完整工作流演示以验证电商应用的登录回归为例输入账号密码、点击登录、断言商品列表出现、点进商品、再断言列表状态变化。仓库里的 simple.yaml 就是这条流程内容如下url: https://www.saucedemo.com/ --- - launchApp - tapOn: Username - inputText: standard_user - tapOn: Password - inputText: secret_sauce - tapOn: Login - assertVisible: Products - tapOn: Sauce Labs Backpack - assertVisible: .*sleek.*流程分三步走准备把 YAML 存到任意目录头部声明urlWeb或appId移动端tags字段可选用于在报告里区分分组。执行在终端运行maestro --platform web test flow.yaml。预期看到终端逐条打印命令与耗时末尾汇总 PASSED断言失败时该行标红并直接给出失败命令和未匹配到的元素信息。核对点进商品后assertVisible: .*sleek.*用正则匹配商品描述验证页面确实切换了。这条流程里的正则选择器就是应对文案里只有部分稳定这类场景的常用手段。 高频问题速查症状可能原因解法Element not found页面尚未加载完或选择器文案与界面实际文本不一致在断言前加waitFor显式等待或maestro hierarchy核对真实文本启动后报无设备或连接失败Android 未开 USB 调试adb 未识别或模拟器未启动adb devices确认在线Web 场景先确认 Chrome 可用必要时maestro start-device拉起一个标准模拟器步骤耗时忽长忽短引擎在自动等待目标元素网络或设备性能波动正常现象无需 sleep确需收紧时为该命令单独设置超时 收尾Maestro 是一个用 YAML 描述流程、跨 Android/iOS/Web 三端执行的移动端 UI 自动化测试框架适合测试团队和开发者沉淀可进 CI 的回归用例如果你要的是实时点屏调试的可视化编排工具配套的是闭源的 Maestro Studio 桌面端代码不在这个仓库里但生成的流程同样是 Maestro 可以执行的 YAML。深入代码可以从 CLI 命令层TestCommand.kt、PrintHierarchyCommand.kt和 Web 平台驱动 两个入口看起测试用例的完整示例则集中在 e2e 工作区。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Maestro：YAML 驱动的移动端 UI 自动化测试——一条登录回归不用写任何代码框架
MaestroYAML 驱动的移动端 UI 自动化测试——一条登录回归不用写任何代码框架【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro你刚改完登录页的按钮交互想确认整条登录流程没被改坏又不想等单元测试之外的任何东西。Maestro 是一个开源的移动端 UI 自动化测试框架用人类可读的 YAML 写流程再在 Android 模拟器、iOS 模拟器或浏览器上直接执行。本文带你从零把本地环境跑通并演示一条电商登录回归的完整工作流。 5 分钟跑通本地环境前置条件只有一个Java 17 及以上java -version确认即可。在仓库内构建并运行一条示例流程git clone https://gitcode.com/GitHub_Trending/ma/maestro cd maestro ./maestro --platform web test e2e/workspaces/web/simple.yaml./maestro是仓库根目录的包装脚本会自动执行 Gradle 构建maestro-cli模块并启动 CLI首次构建需要几分钟。流程访问的是公开站点 saucedemo.com不需要本地起服务。成功信号终端逐条打印launchApp、tapOn、inputText、assertVisible及各自耗时最后一行汇总 PASSED。如果看到 FAIL对照终端里的失败步骤名排查。 核心能力拆解一套命令覆盖 Android、iOS 与 Web同一个团队维护三套测试脚本是常见的负担。Maestro 把交互抽象成平台无关的命令你在流程里只写tapOn: Login、inputText: secret_sauce引擎按目标平台把命令翻译到对应的底层驱动——Android 走 UIAutomator、iOS 走 XCUITest、Web 走 Chrome DevTools 或 Selenium对应代码分别在 Android 驱动、iOS 驱动 与 Web 驱动。使用边界入口参数按平台不同launchApp在 Android/iOS 用appId、在 Web 用url在流程头部声明一次即可。YAML 流程编排与子流程复用多步回归里启动应用、跳过引导页这类步骤会反复出现手写多遍很难维护。YAML 流程本质是一个有序命令列表subFlow可以把公共片段抽成独立文件按相对路径引用多个主流程共享同一段 onboarding 逻辑。仓库的 e2e 目录本身就是范例Wikipedia 测试工作区 用subFlow复用 launch-clearstate-android.yaml 等片段按 Android/iOS 分目录组织。注意子流程继承的是相对路径解析文件挪动后先跑一遍checkSyntax更稳妥。智能等待与失败取证动态 UI 场景下手动sleep()要么等太久要么根本不够偶发失败又难以复现。每条命令执行前引擎会自动轮询目标元素等到出现或超时为止你也可以用waitFor显式指定等待条件与时长自 2.7.0 起每个步骤执行前会自动截图失败时把该步截图和视图层级一并打进调试产物目录配合maestro hierarchy打印的层级 JSON 即可离线分析不必反复重跑。定位问题时优先看调试目录里的截图和层级文件。 一个完整工作流演示以验证电商应用的登录回归为例输入账号密码、点击登录、断言商品列表出现、点进商品、再断言列表状态变化。仓库里的 simple.yaml 就是这条流程内容如下url: https://www.saucedemo.com/ --- - launchApp - tapOn: Username - inputText: standard_user - tapOn: Password - inputText: secret_sauce - tapOn: Login - assertVisible: Products - tapOn: Sauce Labs Backpack - assertVisible: .*sleek.*流程分三步走准备把 YAML 存到任意目录头部声明urlWeb或appId移动端tags字段可选用于在报告里区分分组。执行在终端运行maestro --platform web test flow.yaml。预期看到终端逐条打印命令与耗时末尾汇总 PASSED断言失败时该行标红并直接给出失败命令和未匹配到的元素信息。核对点进商品后assertVisible: .*sleek.*用正则匹配商品描述验证页面确实切换了。这条流程里的正则选择器就是应对文案里只有部分稳定这类场景的常用手段。 高频问题速查症状可能原因解法Element not found页面尚未加载完或选择器文案与界面实际文本不一致在断言前加waitFor显式等待或maestro hierarchy核对真实文本启动后报无设备或连接失败Android 未开 USB 调试adb 未识别或模拟器未启动adb devices确认在线Web 场景先确认 Chrome 可用必要时maestro start-device拉起一个标准模拟器步骤耗时忽长忽短引擎在自动等待目标元素网络或设备性能波动正常现象无需 sleep确需收紧时为该命令单独设置超时 收尾Maestro 是一个用 YAML 描述流程、跨 Android/iOS/Web 三端执行的移动端 UI 自动化测试框架适合测试团队和开发者沉淀可进 CI 的回归用例如果你要的是实时点屏调试的可视化编排工具配套的是闭源的 Maestro Studio 桌面端代码不在这个仓库里但生成的流程同样是 Maestro 可以执行的 YAML。深入代码可以从 CLI 命令层TestCommand.kt、PrintHierarchyCommand.kt和 Web 平台驱动 两个入口看起测试用例的完整示例则集中在 e2e 工作区。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考