Maestro record 上手指南：一条命令生成第一条测试脚本

Maestro record 上手指南：一条命令生成第一条测试脚本

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

Maestro 是一个开源的移动应用自动化测试框架，让你用人类可读的 YAML 描述测试流程，跑在 Android、iOS 的模拟器、真机或浏览器上。它的 Maestro record 录制功能替你省去手写脚本的起步工作：你在应用里操作一遍，它就自动把交互写成一份可运行的 YAML 测试脚本。这篇文章讲清楚录制到底做什么、怎么用、边界在哪，适合刚接触移动 UI 测试的测试和开发人员。

先从一个场景说起

新版本发布后，你常要快速补一条主流程回归测试，确认登录、下单这些关键路径没被改坏。手写 YAML 时步骤容易漏、格式也容易错，来回调试很花时间。Maestro record 的出发点是：让你亲自把流程走一遍，再让工具把过程回写成脚本，先拿到草稿再慢慢改。

它做了什么

录制过程中，Maestro 会捕获你在应用里的点击、输入、滑动等操作，并识别每个操作落在哪个界面上。它把这些动作整理成一份 YAML 流程文件，内容是可读的 tapOn、inputText、assertVisible 等指令，而不是一堆坐标数字。文件最终落在你本地项目里，是一个可以直接提交、也可以继续编辑的 .yaml 脚本。

一条命令走完全程

先安装 CLI。装完后，你的终端里就有了 maestro 命令。

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

接着运行下面这条命令，工具会连上你指定的模拟器或真机。你在应用里像平时一样操作，它全程记录，不需要你预先写好任何东西。

maestro record

操作做完，终端里会多出一份 YAML 脚本。这份脚本就是自动生成的测试脚本，你拿到它就可以直接当起点。

拿到脚本之后

这份脚本可以直接用 maestro test 跑起来，不做修改也能执行。跑之前建议扫一遍元素定位，把录制时抓到的临时文案换成更稳定的标识，例如 accessibility id 或 test id。如果某个元素定位不稳定，先用较宽的条件匹配、再逐步收紧，比一上来就卡死某个控件更能扛住版本迭代，结构上可以参考 Wikipedia 搜索示例流程。

录制时也会记下滚动、等待等动作，脚本里对应的断言会先等元素可见再执行，比纯硬编码坐标更稳。你不必一开始就追求每个断言都严丝合缝，能跑通主流程、再逐步补强，是更省力的节奏。

什么时候用它，什么时候别用

它适合快速搭冒烟测试和主流程回归，几分钟就能拿到一版可用脚本，也覆盖 Android、iOS 原生以及 Flutter、React Native 等跨平台框架。需要复杂条件断言、严格数据校验，或做性能、稳定性测试时，录制帮不上太多忙，那些逻辑仍要你在脚本里手动补。比如登录页改版换了个图标，录制稿里那条 tapOn 往往要换成新的 test id，这一步还是得你来。

一句话边界：录制负责把草稿交到你手上，判断哪些该断言、哪些该加固，始终靠你。

Maestro record 把「操作到脚本」这一步自动化了，省掉的是搭骨架的时间，而不是替你思考。它生成的脚本可读、可提交、可继续改，是回归测试的一个好起点。先跑一条主流程，草稿在手，再决定要不要往套件里扩。

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