企业官网建设流程全解析

Maestro 录制功能实战：5 分钟自动生成移动应用测试脚本的完整指南

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

Maestro 录制功能只需操作应用一遍，就能自动生成移动应用测试脚本，顺带留下一份带画面的执行视频。不用手写 YAML，测试新手也能在几分钟内拿到能直接跑的 YAML 测试脚本。

先看懂：为什么需要它

手写移动应用测试脚本这件事，劝退了不少人。一个流程十几步，每一步都得敲出 tapOn、inputText、assertVisible，还得自己处理等待。写完再调试，来回折腾半天，新人上手更慢。

Maestro 录制把这条路反过来：你在应用里正常点一遍，它观察你的操作，自动生成一份 YAML 测试脚本。手写环节基本被跳过，剩下的只是检查、微调。

从安装到出脚本

📥 一行命令安装 Maestro CLI

先确认本机装了 Java 17 或更高版本，然后执行：

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

macOS、Linux 和 Windows（WSL）都能装，装完终端里就有maestro命令了。

🎬 一条命令开启录制会话

maestro record <你的流程.yaml>

两个注意点：它只接收单个 YAML 文件，传目录会报错；Web flow 目前还不支持。想在自己机器上渲染视频就加--local，默认产物是 maestro-recording.mp4。

📲 在应用里执行操作生成 YAML 测试脚本

打开 Android 模拟器、iOS 模拟器或真机上装好的应用，按真实使用习惯把流程走一遍。你的每次点击和输入都会被翻译成对应步骤。遇到"元素还没出现"的情况，Maestro 内置的等待机制会一直轮询到超时，不用你手动加 sleep，这是它比手写脚本稳的关键之一。

🧾 拿到脚本并运行

结束后手里有两样东西：一份能直接跑的 YAML 脚本，一份带画面和步骤时间线的 mp4。脚本交给 CI，用maestro test跑；视频直接丢进演示材料或 bug 单。想查实现细节，可以看 RecordCommand.kt。

录出来的脚本能用在哪儿

• 📱联系人管理回归：把新建联系人、填资料、保存、再搜索验证的完整链路录下来，当作回归用例，UI 改版后重跑一遍对比结果。
• 🛒电商关键路径守护：浏览商品、加购、到结算支付这条线，录一次存进仓库，每次发版前跑一遍，出问题第一时间知道。
• 🎥演示和 bug 报告：record 产出的视频比截图有说服力，发给同事或贴到工单里，一眼看懂问题发生的位置。

上手后别踩这些坑

• 元素定位别只靠文字：优先选 resourceId、testId 这类固定标识，文字标签文案一改脚本就挂。生成后先人工核对一遍定位方式。
• 动态数据别录死：订单号、验证码、日期这类每次不同的内容，录出来的是死值。生成脚本后把它们替换成变量或固定测试数据。
• 跨平台留点余地：Android iOS 跨平台测试时，同一个控件在两个平台的文本常常不一样。仓库 e2e 目录里的示例就是按平台分开的，可以照这个思路拆。

相比手写脚本，这条路省掉的是成片的重复劳动：录一次，脚本和演示视频一起到手，脚本还能当流程文档看。界面改版后重跑一遍比从零写快得多。打开终端试试maestro record，五分钟就能见到第一份脚本。

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