十分钟让一份 UI 用例在 Android、iOS、Web 三端变绿：Maestro 完整指南

十分钟让一份 UI 用例在 Android、iOS、Web 三端变绿Maestro 完整指南【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro想象一个画面你提交一个 YAML 文件CI 里 Android、iOS、Web 三条流水线同时变绿。而现实里常见的另一面是首页改版一次三套定位符要挨个重改。Maestro 是一个跨平台 UI 自动化测试框架用 YAML 描述步骤、按文本和语义找元素并且内置智能等待不写 sleep。这篇指南带你完成安装验证、跑通第一个登录用例再把它调到稳定。卖点速览传统方案里Android 用 Espresso、iOS 用 XCTest、Web 再拉一套工具三种写法各维护一份断言。Maestro 把这些压成一份描述对比维度传统多框架方案Maestro平台数每端各写各的三套维护一份 YAML 三端复用定位方式精确选择器路径改 UI 就断文本与语义定位抗变更等待策略手写 sleep短了挂、长了慢智能等待自动等元素出现是否编译需要构建编译解释执行改完即跑[!TIP] 脚本读起来像一份测试用例描述而不是一段代码。这份可读性就是它最直接的体验差异。从零到跑通 ️前置条件只有一个Java 17 及以上用java -version确认。macOS、Linux、WindowsWSL均可。curl -fsSL https://get.maestro.mobile.dev | bash export PATH$PATH:$HOME/.maestro/bin maestro --version自检标准只有一条命令打印出版本号环境即就绪。接下来写最小登录用例。一个 Flow 就是一个 YAML 文件头部声明appId移动端包名与tags---之后的行按顺序执行。appId: com.example.ecommerce tags: - login - positive --- - launchApp: clearState: true - tapOn: 我的账户 - inputText: standard_user - inputText: secret_sauce - tapOn: 登录 - assertVisible: 我的订单命令作用launchApp启动应用clearState: true清空状态环境干净tapOn点击匹配到的元素inputText向焦点元素输入文本assertVisible断言元素可见找不到则判失败跑完看到步骤逐条变绿第一步就算完成。负向用例不需要新结构换一组锁定账号数据、末尾断言错误提示即可。需要分支时用if/then/else表达比如仅当验证码可见才输入否则点跳过。偶发失败怎么办先说默认行为Maestro 会在点击、断言前自动等待元素就绪多数页面没加载完的抖动不需要处理。当某条断言仍偶尔变红有两种写法- retry: maxAttempts: 3 interval: 1000 command: assertVisible: 加载完成把容易失手的步骤包一层重试最多试 3 次、每次间隔 1 秒。另一种是拉长单条断言的等待上限- assertVisible: text: 支付成功 timeout: 10000注意边界这两种手段都是等更久不是一直等。超时之后依然失败问题就不在等待回去查用例和数据。定位三问 Element not found大多不是元素不存在而是定位条件给得太死。按排查成本从低到高问三个问题应用状态对不对页面可能没翻到正确位置或上次运行污染了状态。给launchApp加clearState: true冷启动复现一次能不能模糊匹配文本里带单号、时间这类动态内容时用contains只匹配稳定片段同名元素怎么区分两个提交并存时用parent把范围锁进目标容器。- tapOn: text: contains: 订单号 - tapOn: text: 提交 parent: text: 表单先跑冷启动复现再逐步放宽定位别一上来就改选择器。跨端执行移动端与 Web 端只差头部一个字段移动端写appId指定包名Web 端用url指向页面地址后面的步骤完全同构。仓库自带示例 e2e/workspaces/web/simple.yamlurl开头输入用户名、密码、点登录命令与移动端写法一致。逻辑只写一遍元素在各端找得到就行。要反复造随机数据时inputRandomEmail、inputRandomNumber可以在运行时现生成邮箱或指定范围的数字不必把测试数据写死。交给 CI 前的验收三件事做完这份用例就够格进 CI验收项判定标准负向分支锁定账号输入后错误提示断言变绿Web 版同一条流程换url后跑通稳定性加固偶发失败点套上retry或timeout连续多轮不再翻红到这一步真正的收尾不是继续堆用例数量而是确认这几条在 Android、iOS、Web 三端都稳定变绿。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考