Maestro 录制上手：5 分钟把 YAML 流程变成演示视频

Maestro 录制上手：5 分钟把 YAML 流程变成演示视频

【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro

每次演示或报 bug，你都要先开录屏、再手动修掉开头和结尾？试试 Maestro 的 record 录制功能：它直接执行你的 YAML 流程，跑完自动输出一段干净的 1080p 视频，不用自己录屏、不用剪辑。

先看效果：一段流程直接出片

把已经写好的 YAML 流程丢给maestro record，执行过程会被自动渲染成带步骤提示的视频，导出即 MP4。Android 和 iOS 都支持，下面这段动画就是用它录出来的“添加联系人”流程：

它凭什么值得用

• 一条命令出片：录屏、渲染、封装一步到位，产物是 1080p MP4，直接发群或贴 issue 都行。
• 跨平台：Android 模拟器、iOS 模拟器和真机都能录，同一套流程不用改。
• 离线也能录：加--local在本地渲染，不依赖云端服务，还能源自己指定输出文件。
• 步骤可复现：视频来自 YAML 流程本身，同一个文件任何时候重录都保持一致。

从零到跑通：安装命令到出视频

1. 检查 Java 环境

java -version

Maestro 要求 Java 17 或更高，低于这个版本先升级再继续。

2. 安装 Maestro CLI

curl -fsSL "https://get.maestro.mobile.dev" | bash

macOS、Linux 和 Windows（WSL）都可以直接跑这条安装命令。

3. 启动一台设备

打开 Android 模拟器或 iOS 模拟器即可，确认设备处于运行状态。

4. 准备一个 YAML 流程文件

appId: com.android.contacts --- - launchApp - tapOn: "Create new contact"

内容不用多，两三条命令就够用来体验录制。仓库里 e2e/demo_app 下有现成示例可以参考。

5. 录制并生成视频

maestro record flow.yaml

执行完成后，默认输出maestro-recording.mp4。想自定义输出位置，加上--local：

maestro record flow.yaml --local out.mp4

实战场景

给 bug 配上证据：把复现步骤写成 YAML 流程，用maestro record录一遍，视频里每一步都有对应命令，开发同学对着看就能定位问题，不用再解释“当时点了哪”。

发版演示素材：新版本上线前，把核心功能串成一个流程并录制成视频，放进 release notes 或周报，比几张截图直观得多。

不想依赖云渲染：给命令加上--local，视频在你自己的机器上渲染完成，适合网络受限的环境。

进阶技巧：让录出来的视频更好看

• 流程保持短小：视频时长等于流程执行时长，流程拖沓视频就拖沓；建议单段流程控制在十几步以内。
• 断言放在关键节点：在tapOn之后补一条assertVisible，能顺带确认关键页面真的加载出来了。
• 注意 Web 流程暂不支持：maestro record目前只支持 Android/iOS 流程，遇到 web 流程会直接报错，别浪费时间排查。

常见问题

maestro record 是录用户操作吗？

不是。它执行的是你写好的 YAML 流程，把执行过程渲染成视频；想要“边操作边生成脚本”的体验，请配合 Maestro Studio 的可视化录制功能使用。

视频输出到哪里？

默认在调试目录里生成maestro-recording.mp4；用--local时可以自己指定输出路径。

iOS 上能录吗？

可以，启动 iOS 模拟器后即可用同样的命令录制。

生成的视频能直接分享吗？

可以。输出就是标准 MP4，1920x1080，发聊天工具、贴 issue、放进演示文稿都没问题。

到这里，你已经掌握了从装好 CLI 到产出第一段流程视频的完整路径。打开终端，挑一个最常用的流程跑一遍maestro record试试，几分钟就能看到成片。

【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro