Maestro 移动 UI 自动化测试5 个环节拆解 YAML 工作流【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/MaestroMaestro 用声明式 YAML一种用缩进和列表描述数据结构的脚本格式编写移动 UI 自动化测试同一份脚本可以直接跑在 Android 与 iOS 上。这篇文章不按学习阶段组织而是按编写 → 执行 → 调试 → 复用 → 扩展的真实工作流拆解它的核心能力从最小可运行脚本到等待策略、录制回放、runFlow子流程调用复用与 MCP 集成全部以仓库内真实的 e2e 用例为依据示例集中在 e2e/workspaces/ 下。编写最小可运行 YAML 脚本与断言写法Maestro 脚本的最小单元是一条扁平的命令序列平台差异被引擎封装掉你只描述做什么。launchApp 前置块与基础命令序列下面这段取自仓库内的 Web 登录示例演示一条最小可运行的脚本长什么样appId: https://www.saucedemo.com/ # Web 测试时 appId 也可以直接写 URL --- - launchApp - tapOn: Username - inputText: standard_user # 直接打入上一次 tap 聚焦到的输入框 - tapOn: Login - assertVisible: Products关键参数appId对原生应用是包名对 Web 页面可以换成 URLinputText作用于当前聚焦的输入框所以前面不需要再指定元素。元素定位id、text 与断言组合定位的稳定性排序通常是idtext 视觉特征仓库里的 iframe 测试展示了嵌套容器下的定位与断言组合# 断言目标是 iframe 内部的元素证明查询能穿透嵌套容器 - assertVisible: id: echo-output text: Potato - assertNotVisible: Type here... # 占位符被输入替代后消失断言消失比断言出现更稳关键参数id在 Android 侧对应资源 id、iOS 侧对应 accessibility identifier是最稳定的定位锚点assertNotVisible这类否定断言适合验证占位符消失弹窗关闭这类状态迁移。执行等待策略与 retry 兜底的 YAML 写法偶发失败几乎都来自时序问题解法是把等待显式写进脚本而不是靠调大默认超时。extendedWaitUntil 处理长时异步加载仓库里 WebView 加载用例对慢加载页面给出了长超时等待的写法# 慢加载页面显式给出 90 秒上限并写明人类可读的标签 - extendedWaitUntil: visible: Login timeout: 90000 label: Wait for Login page to load关键参数timeout单位为毫秒label会出现在报告里超时时能直接定位到卡在哪个语义步骤而不是一个匿名等待。retry 包裹不稳定交互点击被静默吞掉、动画未完成这类问题用重试包裹比加等待更干净# 温设备上的点击可能被静默吞掉重试 否定断言确认导航确实发生 - retry: maxRetries: 2 commands: - tapOn: Open Login Page - assertNotVisible: Open Login Page关键参数maxRetries是额外重试次数注意commands内要以断言收尾否则重试无法判断上一次尝试是否真正成功。调试studio 单步、record 录制与层级导出失败时最贵的成本是复现Maestro 把单步调试、操作录制和元素树导出都做进了 CLI。maestro studio 与 record 的分工 调试路径按问题类型选怀疑逻辑顺序用 studio怀疑当时屏幕上长什么样用 recordmaestro studio e2e/workspaces/web/simple.yaml # 单步调试图形界面逐步执行失败即停 maestro record # 录制真实手势操作回放生成可复现脚本 maestro printHierarchy # 导出当前屏幕元素树核对定位依据关键参数studio接收一个流程文件可在界面上逐步执行并查看每步匹配到的元素printHierarchy作用于当前连接的设备输出的层级结构是排查点错元素的第一手材料。printHierarchy 导出元素树排查定位元素定位失败时先跑一次printHierarchy确认目标元素的id/text在当前设备上是否真实存在、文案是否与脚本一致。仓库的调试类命令PrintHierarchyCommand、StudioCommand、RecordCommand都集中在 maestro-cli/src/main/java/maestro/cli/command/ 下需要深挖实现时直接看这里。复用runFlow 子流程拆分与变量传递模式重复代码是测试套件腐化的起点runFlow 把公共步骤拆成可独立维护的子流程。跨平台分支按平台拆分 subflowsWikipedia 示例的流程文件把平台差异收敛到子流程主流程只写runFlow: subflows/onboarding-android.yaml或onboarding-ios.yaml引导页、清状态等步骤各自独立成文件放在 e2e/workspaces/wikipedia/subflows/ 下。另一招是optional: true——元素不存在时跳过该步而非报错用它吸收两个平台版本间的 UI 漂移。runScript 注入动态数据搜索类用例需要每次生成不重复的查询词仓库的进阶流程展示了脚本返回值的传递方式- runFlow: subflows/onboarding-android.yaml # 公共引导步骤抽成子流程多处复用 - runScript: scripts/getSearchQuery.js # JS 在运行时生成随机搜索词 - inputText: ${output.result} # 把脚本返回值带入下一步 - assertVisible: ${output.result}关键参数output是脚本写出的内置变量用${output.xxx}引用runFlow的路径相对于当前流程文件所在目录解析。扩展Web 端测试与 MCP 集成Maestro 的能力边界不止于原生 UI 命令脚本钩子和 Web 驱动把测试接进了更大的生态。同一套 YAML 跑 Web 端e2e/workspaces/web/下的用例证明了同一套命令可以驱动浏览器appId换成 URL 后tapOn、inputText、assertVisible语义不变SPA 路由跳转spa_navigation.yaml和同源 iframe 内的输入iframe_same_origin.yaml都有对应用例覆盖。MCPLLM 直接驱动设备的协议MCPModel Context Protocol一种让 LLM 调用外部工具的标准协议集成后LLM 可以直接读取屏幕状态、执行点击与断言把探索式测试接进现有流程。相关实现位于 maestro-cli/src/main/java/maestro/cli/mcp/配合 CLI 的 mcp 子命令即可把 Maestro 注册为模型可驱动的设备端点。能力边界速览Maestro 擅长声明式 UI 层 E2E跨平台脚本复用、元素与视觉断言、录制回放调试以及通过 MCP 把 LLM 接进测试流程它不擅长设备内部状态——网络延迟、崩溃堆栈、性能指标和纯业务逻辑验证这些仍需仪器化测试或真机实验室补齐。对 Web 端它能覆盖常规交互与断言但深层 DOM 操作能力弱于专用浏览器自动化工具。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Maestro 移动 UI 自动化测试：5 个环节拆解 YAML 工作流
Maestro 移动 UI 自动化测试5 个环节拆解 YAML 工作流【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/MaestroMaestro 用声明式 YAML一种用缩进和列表描述数据结构的脚本格式编写移动 UI 自动化测试同一份脚本可以直接跑在 Android 与 iOS 上。这篇文章不按学习阶段组织而是按编写 → 执行 → 调试 → 复用 → 扩展的真实工作流拆解它的核心能力从最小可运行脚本到等待策略、录制回放、runFlow子流程调用复用与 MCP 集成全部以仓库内真实的 e2e 用例为依据示例集中在 e2e/workspaces/ 下。编写最小可运行 YAML 脚本与断言写法Maestro 脚本的最小单元是一条扁平的命令序列平台差异被引擎封装掉你只描述做什么。launchApp 前置块与基础命令序列下面这段取自仓库内的 Web 登录示例演示一条最小可运行的脚本长什么样appId: https://www.saucedemo.com/ # Web 测试时 appId 也可以直接写 URL --- - launchApp - tapOn: Username - inputText: standard_user # 直接打入上一次 tap 聚焦到的输入框 - tapOn: Login - assertVisible: Products关键参数appId对原生应用是包名对 Web 页面可以换成 URLinputText作用于当前聚焦的输入框所以前面不需要再指定元素。元素定位id、text 与断言组合定位的稳定性排序通常是idtext 视觉特征仓库里的 iframe 测试展示了嵌套容器下的定位与断言组合# 断言目标是 iframe 内部的元素证明查询能穿透嵌套容器 - assertVisible: id: echo-output text: Potato - assertNotVisible: Type here... # 占位符被输入替代后消失断言消失比断言出现更稳关键参数id在 Android 侧对应资源 id、iOS 侧对应 accessibility identifier是最稳定的定位锚点assertNotVisible这类否定断言适合验证占位符消失弹窗关闭这类状态迁移。执行等待策略与 retry 兜底的 YAML 写法偶发失败几乎都来自时序问题解法是把等待显式写进脚本而不是靠调大默认超时。extendedWaitUntil 处理长时异步加载仓库里 WebView 加载用例对慢加载页面给出了长超时等待的写法# 慢加载页面显式给出 90 秒上限并写明人类可读的标签 - extendedWaitUntil: visible: Login timeout: 90000 label: Wait for Login page to load关键参数timeout单位为毫秒label会出现在报告里超时时能直接定位到卡在哪个语义步骤而不是一个匿名等待。retry 包裹不稳定交互点击被静默吞掉、动画未完成这类问题用重试包裹比加等待更干净# 温设备上的点击可能被静默吞掉重试 否定断言确认导航确实发生 - retry: maxRetries: 2 commands: - tapOn: Open Login Page - assertNotVisible: Open Login Page关键参数maxRetries是额外重试次数注意commands内要以断言收尾否则重试无法判断上一次尝试是否真正成功。调试studio 单步、record 录制与层级导出失败时最贵的成本是复现Maestro 把单步调试、操作录制和元素树导出都做进了 CLI。maestro studio 与 record 的分工 调试路径按问题类型选怀疑逻辑顺序用 studio怀疑当时屏幕上长什么样用 recordmaestro studio e2e/workspaces/web/simple.yaml # 单步调试图形界面逐步执行失败即停 maestro record # 录制真实手势操作回放生成可复现脚本 maestro printHierarchy # 导出当前屏幕元素树核对定位依据关键参数studio接收一个流程文件可在界面上逐步执行并查看每步匹配到的元素printHierarchy作用于当前连接的设备输出的层级结构是排查点错元素的第一手材料。printHierarchy 导出元素树排查定位元素定位失败时先跑一次printHierarchy确认目标元素的id/text在当前设备上是否真实存在、文案是否与脚本一致。仓库的调试类命令PrintHierarchyCommand、StudioCommand、RecordCommand都集中在 maestro-cli/src/main/java/maestro/cli/command/ 下需要深挖实现时直接看这里。复用runFlow 子流程拆分与变量传递模式重复代码是测试套件腐化的起点runFlow 把公共步骤拆成可独立维护的子流程。跨平台分支按平台拆分 subflowsWikipedia 示例的流程文件把平台差异收敛到子流程主流程只写runFlow: subflows/onboarding-android.yaml或onboarding-ios.yaml引导页、清状态等步骤各自独立成文件放在 e2e/workspaces/wikipedia/subflows/ 下。另一招是optional: true——元素不存在时跳过该步而非报错用它吸收两个平台版本间的 UI 漂移。runScript 注入动态数据搜索类用例需要每次生成不重复的查询词仓库的进阶流程展示了脚本返回值的传递方式- runFlow: subflows/onboarding-android.yaml # 公共引导步骤抽成子流程多处复用 - runScript: scripts/getSearchQuery.js # JS 在运行时生成随机搜索词 - inputText: ${output.result} # 把脚本返回值带入下一步 - assertVisible: ${output.result}关键参数output是脚本写出的内置变量用${output.xxx}引用runFlow的路径相对于当前流程文件所在目录解析。扩展Web 端测试与 MCP 集成Maestro 的能力边界不止于原生 UI 命令脚本钩子和 Web 驱动把测试接进了更大的生态。同一套 YAML 跑 Web 端e2e/workspaces/web/下的用例证明了同一套命令可以驱动浏览器appId换成 URL 后tapOn、inputText、assertVisible语义不变SPA 路由跳转spa_navigation.yaml和同源 iframe 内的输入iframe_same_origin.yaml都有对应用例覆盖。MCPLLM 直接驱动设备的协议MCPModel Context Protocol一种让 LLM 调用外部工具的标准协议集成后LLM 可以直接读取屏幕状态、执行点击与断言把探索式测试接进现有流程。相关实现位于 maestro-cli/src/main/java/maestro/cli/mcp/配合 CLI 的 mcp 子命令即可把 Maestro 注册为模型可驱动的设备端点。能力边界速览Maestro 擅长声明式 UI 层 E2E跨平台脚本复用、元素与视觉断言、录制回放调试以及通过 MCP 把 LLM 接进测试流程它不擅长设备内部状态——网络延迟、崩溃堆栈、性能指标和纯业务逻辑验证这些仍需仪器化测试或真机实验室补齐。对 Web 端它能覆盖常规交互与断言但深层 DOM 操作能力弱于专用浏览器自动化工具。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考