Maestro 移动端自动化测试完整指南5 分钟跑通第一个 E2E 测试【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/MaestroMaestro 是一个开源的移动端和 Web 端到端E2E自动化测试框架覆盖 Android、iOS 和浏览器三种环境。你用 YAML 写测试脚本几行tapOn、assertVisible命令就能直接跑起来不需要驱动、SDK 或编译步骤。一条安装命令装好 CLI5 分钟内就能看到第一次测试结果。 快速开始三步安装并跑通第一个测试先确认系统装有 Java 17 及以上版本java -version查看然后一行命令安装 maestro CLIcurl -fsSL https://get.maestro.mobile.dev | bash写第一个 YAML 测试脚本以contacts.yaml保存。内容就是启动应用、点按钮、输入文字、断言界面appId: com.android.contacts --- - launchApp - tapOn: Create new contact - tapOn: First Name - inputText: John - tapOn: Save - assertVisible: John运行脚本顺便用record把执行过程渲染成一段演示视频maestro test contacts.yaml maestro record contacts.yaml终端里逐条显示命令执行状态全绿即通过。下图是一个真实流程在模拟器上运行 YouTube 系应用Twitch的效果右侧面板实时展示脚本进度⚙️ 工作原理通过系统无障碍层驱动应用Maestro 不依赖任何框架的 SDK它通过操作系统自带的无障碍层读取界面、模拟点击和输入。所以不管被测应用是原生 Android/iOS、Flutter 还是 React Native看到的都是同一套元素树同一份命令通用。扁平命令列表免编译即时执行一个测试就是一份扁平的 YAML 列表第一行启动应用第二行点按钮第三行断言文字出现。maestro test逐行解释执行没有编译环节改一行就能立刻重跑。YAML 流程引擎的核心实现在 maestro-orchestra/ 目录。 功能拆解一份流程同时跑 Android、iOS 和浏览器同一个 YAML 文件可以在 Android 模拟器、iOS 模拟器和真实浏览器里执行。Web 场景下appId直接填页面 URL 即可仓库里的 e2e/workspaces/web/ 目录有一份现成示例。你能得到的是一套脚本维护三个端回归测试不用各写一遍。智能等待与重试替代手写 sleep页面加载慢、动画没播完是移动端测试最常见的坑。Maestro 内置自动等待机制命令会等目标元素真正出现再执行不稳定的步骤可以用retry包一层用extendedWaitUntil指定更长的等待上限。你得到的是不需要反复调等待时间的脚本偶发抖动也能自动通过。把测试脚本渲染成演示视频maestro record会把整条流程的执行画面渲染成一段视频文件命令描述很适合做演示和 bug 报告。输出就是一个 mp4哪一步点了哪里、界面如何变化、最终卡在哪里一目了然直接附在缺陷单里。把真机交给你的 AI 编程代理maestro MCP 服务器内置在 CLI 里maestro mcp启动无需额外安装。Claude Code、Cursor 等任何 MCP 客户端接入后代理可以在真实设备上查屏幕、点击、滚动、断言自己验证刚写的功能还能按你的要求产出一条可复跑的 YAML 流程。下面是代理通过 MCP 控制模拟器、每条命令实时显示在 Viewer 里的画面 实战示例示例一联系人创建流程回归输入7 行的contacts.yaml 一台已启动的 Android 模拟器maestro list-devices能看到设备。输出终端逐条打印每个命令的通过/失败结果全部通过则退出码为 0可直接接进 CI某条失败时能定位到具体是哪一行配合maestro record生成的视频就是完整的复现材料。示例二Web 单页应用导航验证输入把appId指向本地起的一个登录页 URL脚本先断言 Login 可见点击 Log In再断言 Dashboard 出现。输出同样是逐条执行结果。仓库里的 e2e/workspaces/web/spa_navigation.yaml 就是这个用例的完整写法照着改 URL 就能用。️ 避坑指南提示找不到设备先运行maestro list-devices确认设备在线再启动对应模拟器或连接手机后重试iOS 目前仅支持模拟器真机暂不可用。断言偶发失败元素没找到不要在脚本里加sleep硬等改用extendedWaitUntil指定等待上限或把易抖动的命令包进retry。安装或运行时报 Java 相关错误Maestro 要求 Java 17 或更高运行java -version核对低于 17 就升级 JDK 再执行 CLI。写在最后Maestro 用YAML 脚本 一条安装命令把 Android、iOS 和 Web 的端到端测试门槛降到很低脚本、视频、代理自测三类产出都能直接用于日常回归和缺陷定位。想上手的话从 e2e/workspaces/ 的现成示例脚本起步再配合 e2e/demo_app/ 里的演示应用多跑几遍即可。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考