企业官网建设流程全解析

用 Maestro 建立 UI 响应时间基准：从搭建环境到 CI 跑通的性能测试实践

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

Maestro 是一个移动与 Web 的 E2E 自动化测试工具（Painless E2E Automation for Mobile and Web），除了点按钮、查元素，它也能当性能测试的尺子用：同一套流程反复跑，把每次的响应耗时记录下来，就能给团队的 UI 速度立一条可对比的基准线。本文按"装环境 → 选脚本引擎 → 调超时 → 传基准数据"的顺序，把这条链路走通，最后列出几个容易踩的坑。

从源码装 Maestro：两条命令加一个 Java 环境

性能基准测试的前提是环境可复现，所以直接从源码装比装二进制包更可控。克隆仓库：

git clone https://gitcode.com/GitHub_Trending/ma/maestro cd maestro

跑安装脚本，它会把 Maestro 装到~/.maestro，并把~/.maestro/bin加进 PATH：

./scripts/install.sh

脚本会先检查三样东西：java、unzip、curl，缺哪个会直接提示你用包管理器补上。注意：如果机器上已有 Homebrew 装的 Maestro，脚本会拒绝覆盖，让你先brew uninstall maestro再重跑。

装完不用急着自己写脚本。仓库自带了一批示例流程，在 e2e/workspaces/ 下，比如e2e/workspaces/simple_web_view/webview.yaml，还有完整的演示应用 e2e/demo_app/。拿一个现成 flow 在模拟器上跑通，是建立基准前的第一件事。

脚本引擎怎么选：Rhino 已被移除，删掉配置行即可

Maestro 流程里的runScript命令允许你内嵌 JavaScript，写点自定义计时逻辑很方便。这块背后有个 JS 引擎，早期默认是 Rhino，现在已切换到 GraalJS——GraalJS 执行更快，对现代 JS 特性（比如 ES2020 的??运算符）支持更好。

关键变化：Rhino 已经不是"弃用"，而是直接移除了。如果你老配置里还留着这一行：

- applyConfiguration: config: jsEngine: rhino

校验会直接失败，报错会告诉你The Rhino JS engine has been removed。处理方式只有一条：把jsEngine: rhino删掉，流程默认就走 GraalJS。校验逻辑在 maestro-orchestra/src/main/java/maestro/orchestra/workspace/WorkspaceValidator.kt，运行时还有二次拦截（见 Orchestra.kt）。仓库里maestro-test/src/test/resources/102_graaljs.yaml就是一个用??特性的引擎验证用例，可以参考。

CI 慢设备上怎么配启动超时：MAESTRO_DRIVER_STARTUP_TIMEOUT

这是做性能测试最容易被忽略的一步。基准测试要求环境一致，但 CI 上的模拟器和真机性能参差，最常见的翻车方式不是测出"性能差"，而是直接报iOS driver not ready in time之类的超时错误——驱动还没就绪，流程根本没跑起来。

Maestro 用一个环境变量统一控制驱动就绪的等待上限，Android 和 iOS 两个驱动层都读它：

export MAESTRO_DRIVER_STARTUP_TIMEOUT=300

取值单位是秒。它的作用点在 maestro-client/src/main/java/maestro/drivers/AndroidDriver.kt 和 maestro-ios-driver/src/main/kotlin/xcuitest/installer/LocalXCTestInstaller.kt：超时没就绪就抛异常，而不是无限等。建议只在 CI 里调大它；本地开发环境调大了反而会把"驱动真挂了"延迟成"等得很长"。

基准数据怎么上传、怎么跨版本对比

单台设备上跑出来的耗时只是原始数字，要变成"标准"得能对比。Maestro 的 CLI 提供了 API 上传通道：每次跑完把结果传上去，同时带上一个benchmarkName字段标识这批数据属于哪个基准，后续版本的结果挂到同名基准下就能看趋势。

相关代码在 maestro-cli/src/main/java/maestro/cli/api/ApiClient.kt（requestPart["benchmarkName"] = uploadName处），benchmarkName由运行时的上传名称传入。也就是说：给每个发布版本起一个稳定的基准名，CI 每次跑完自动上传，版本间的响应时间差异就有了统一的对照物。

常见坑：超时误报、引擎报错、单次数据不可信 ⚠️

按踩坑频率排个序：

• CI 上报驱动超时：确认MAESTRO_DRIVER_STARTUP_TIMEOUT是否在流程启动前就 export 了（shell 环境变量的作用域问题），而不是写进了某个不生效的配置文件。
• jsEngine: rhino校验失败：报错信息里写了哪个文件哪一行，直接删掉那行配置，不要试图"降级回 Rhino"——它已经不存在了。
• 单次跑的数据下结论：性能测试对抖动敏感，同一条 flow 连跑三次取稳定值再入库，否则基准线本身就在漂移。
• 在脚本里写固定 sleep：等待统一用waitFor让 Maestro 轮询条件，Thread.sleep式写法会把"等待时间"混进"响应时间"，污染测量结果。

下一步

先拿 e2e/workspaces/ 里的一个 flow 当基线流程，在 CI 上连跑三次确认数据稳定；然后删掉所有残留的 Rhino 配置，给 CI 加一行MAESTRO_DRIVER_STARTUP_TIMEOUT。这两步做完，你的版本间耗时对比才有意义。

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