Maestro AI 测试快速上手指南3 步把自然语言变成移动端 UI 自动化脚本【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro测试应用的登录流程你的第一反应多半是写脚本找用户名输入框、找密码输入框、再点登录按钮。每步都要懂 UI 树和元素属性界面一改就得回头修脚本。用 Maestro 做移动 UI 自动化测试时这件事可以变成一句话意图启动应用输入有效凭据验证登录成功。脚本由 AI 生成并执行。下面这份指南带你三步跑通 Maestro 的 AI 测试。一分钟认识 Maestro AIMaestro 是一款面向移动端和 Web 的端到端自动化工具它的 AI 能力让你用自然语言测试脚本替代手写定位代码。AI 功能源码在 maestro-ai/src/ 模块里同时支持 OpenAI 和 Anthropic 两个模型家族设置一个MAESTRO_CLI_AI_KEY环境变量就能激活。它解决的是三件具体的事。一是编写成本你描述测试意图AI 生成可执行脚本不需要逐个元素定位。二是维护成本UI 改版后AI 会重新识别界面元素来适配断言而不是让整条脚本报废。三是跨平台碎片化同一段自然语言描述Android 和 iOS 都能跑Android 的返回键、iOS 的手势返回这类平台差异由 AI 自动处理。⚡ 快速上手三步跑通第一条 AI 测试整个过程只有几条命令和一份短 YAML 文件十几分钟能走完。第一步准备环境。克隆仓库并进入目录git clone https://gitcode.com/GitHub_Trending/ma/maestro cd maestro第二步构建 AI 模块并配置密钥./gradlew :maestro-ai:installDist export MAESTRO_CLI_AI_KEYsk-...构建脚本会生成演示可执行文件放在maestro-ai/build/install/下。密钥直接填 OpenAI 或 Anthropic 的系统会按前缀自动路由到对应模型。第三步写第一条测试并运行appId: com.example.myapp --- - launchApp: clearState: true - assertWithAI: assertion: 登录界面可见包含用户名和密码输入框运行后你会发现AI 解析了界面层级并直接给出通过与否的结论。想单独体验视觉检测演示程序还能直接吃截图maestro-ai-demo foo_1_bad.png它返回这张图是否含视觉缺陷加--show-prompts可以看到发给模型的提示词和原始响应。三大核心能力意图式断言自然语言直接变测试脚本一句话结论断言用中文写AI 负责把它变成可执行的检查逻辑。- launchApp: clearState: true - assertWithAI: optional: true assertion: 登录界面可见包含用户名和密码输入框AI 会自动解析界面层级识别输入框、按钮这类关键元素再判定断言结果。登录流程、新手引导、列表页都能这么写。你不再纠结选择器怎么写界面小改时同一句描述也大概率还能用。智能视觉缺陷检测截图里的问题 AI 自己找一句话结论截个图交给assertNoDefectsWithAI布局错乱、元素重叠、颜色异常自动扫一遍。- launchApp: clearState: true - tapOn: 缺陷测试 - assertNoDefectsWithAI: optional: true - assertWithAI: 界面上显示了一张可爱的兔子图片这是仓库演示应用里的真实场景进入缺陷测试页先让 AI 扫视觉异常再验证兔子图片确实显示。传统视觉回归要手动截图对比这里 AI 直接看图下结论。做 UI 一致性检查的成本低了很多。Android iOS 统一测试一份描述跑两个平台一句话结论同一段自然语言指令两个平台生成各自的脚本不用维护两套代码。- launchApp: com.example.myapp - assertWithAI: assertion: 主界面导航菜单显示正常平台差异被收在 AI 层和底层驱动里比如 Android 的返回键与 iOS 的手势返回。描述用业务语言写平台细节交给框架。完整的 Android、iOS 流程示例在测试工作区 e2e/workspaces/ 里可以直接照着改。让测试跑得稳智能等待、自适应重试与 MCP 工具集AI 测试最怕结果忽对忽错Maestro 用三层机制来兜底。第一层智能等待。用extendedWaitUntil动态调整元素查找的超时- extendedWaitUntil: visible: 登录按钮 timeout: 30000 label: 等待登录页面加载完成第二层自适应重试。内置状态稳定检测界面没稳定下来就先等失败用例智能重试避免动画或网络抖动造成误判。第三层MCP 工具集。Maestro 控制协议服务器把 14 种测试工具暴露给大模型覆盖设备管理list_devices、start_device、界面交互tap_on、input_text、back、文档查询query_docs、cheat_sheet和流程控制run_flow、run_flow_files。评估系统用 LLM-Judge 给工具调用准确性打分判断阈值 0.8保证 AI 决策可靠。完整工具清单见 maestro-cli/src/test/mcp/full-evals.yaml。省钱与进阶API 调用是真金白银Maestro 设计了三档成本优化用例缓存重复场景直接复用历史分析结果不重复烧 Token。模型分级简单断言走 Claude-3-5-Haiku 这类轻量模型复杂场景再上大模型。增量分析只处理界面变化的区域减少单次请求的输入量。后续路线图上还有三个方向 多模态测试融合能验证语音交互比如断言用户说你好时应用的语音回应。 自修复测试脚本元素变化导致失败时AI 分析新界面并自动更新定位策略。️ 开发者协同平台Maestro Studio 在开发环境里给实时测试建议描述需求即生成用例。下一步从一条断言开始别急着重构整套脚本先挑一个你熟悉的页面给它加一条assertWithAI断言跑一遍。看 AI 怎么描述界面、结论是否靠谱。这条走通了再往登录流程、缺陷检测和双平台场景扩展。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Maestro AI 测试快速上手指南：3 步把自然语言变成移动端 UI 自动化脚本
Maestro AI 测试快速上手指南3 步把自然语言变成移动端 UI 自动化脚本【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro测试应用的登录流程你的第一反应多半是写脚本找用户名输入框、找密码输入框、再点登录按钮。每步都要懂 UI 树和元素属性界面一改就得回头修脚本。用 Maestro 做移动 UI 自动化测试时这件事可以变成一句话意图启动应用输入有效凭据验证登录成功。脚本由 AI 生成并执行。下面这份指南带你三步跑通 Maestro 的 AI 测试。一分钟认识 Maestro AIMaestro 是一款面向移动端和 Web 的端到端自动化工具它的 AI 能力让你用自然语言测试脚本替代手写定位代码。AI 功能源码在 maestro-ai/src/ 模块里同时支持 OpenAI 和 Anthropic 两个模型家族设置一个MAESTRO_CLI_AI_KEY环境变量就能激活。它解决的是三件具体的事。一是编写成本你描述测试意图AI 生成可执行脚本不需要逐个元素定位。二是维护成本UI 改版后AI 会重新识别界面元素来适配断言而不是让整条脚本报废。三是跨平台碎片化同一段自然语言描述Android 和 iOS 都能跑Android 的返回键、iOS 的手势返回这类平台差异由 AI 自动处理。⚡ 快速上手三步跑通第一条 AI 测试整个过程只有几条命令和一份短 YAML 文件十几分钟能走完。第一步准备环境。克隆仓库并进入目录git clone https://gitcode.com/GitHub_Trending/ma/maestro cd maestro第二步构建 AI 模块并配置密钥./gradlew :maestro-ai:installDist export MAESTRO_CLI_AI_KEYsk-...构建脚本会生成演示可执行文件放在maestro-ai/build/install/下。密钥直接填 OpenAI 或 Anthropic 的系统会按前缀自动路由到对应模型。第三步写第一条测试并运行appId: com.example.myapp --- - launchApp: clearState: true - assertWithAI: assertion: 登录界面可见包含用户名和密码输入框运行后你会发现AI 解析了界面层级并直接给出通过与否的结论。想单独体验视觉检测演示程序还能直接吃截图maestro-ai-demo foo_1_bad.png它返回这张图是否含视觉缺陷加--show-prompts可以看到发给模型的提示词和原始响应。三大核心能力意图式断言自然语言直接变测试脚本一句话结论断言用中文写AI 负责把它变成可执行的检查逻辑。- launchApp: clearState: true - assertWithAI: optional: true assertion: 登录界面可见包含用户名和密码输入框AI 会自动解析界面层级识别输入框、按钮这类关键元素再判定断言结果。登录流程、新手引导、列表页都能这么写。你不再纠结选择器怎么写界面小改时同一句描述也大概率还能用。智能视觉缺陷检测截图里的问题 AI 自己找一句话结论截个图交给assertNoDefectsWithAI布局错乱、元素重叠、颜色异常自动扫一遍。- launchApp: clearState: true - tapOn: 缺陷测试 - assertNoDefectsWithAI: optional: true - assertWithAI: 界面上显示了一张可爱的兔子图片这是仓库演示应用里的真实场景进入缺陷测试页先让 AI 扫视觉异常再验证兔子图片确实显示。传统视觉回归要手动截图对比这里 AI 直接看图下结论。做 UI 一致性检查的成本低了很多。Android iOS 统一测试一份描述跑两个平台一句话结论同一段自然语言指令两个平台生成各自的脚本不用维护两套代码。- launchApp: com.example.myapp - assertWithAI: assertion: 主界面导航菜单显示正常平台差异被收在 AI 层和底层驱动里比如 Android 的返回键与 iOS 的手势返回。描述用业务语言写平台细节交给框架。完整的 Android、iOS 流程示例在测试工作区 e2e/workspaces/ 里可以直接照着改。让测试跑得稳智能等待、自适应重试与 MCP 工具集AI 测试最怕结果忽对忽错Maestro 用三层机制来兜底。第一层智能等待。用extendedWaitUntil动态调整元素查找的超时- extendedWaitUntil: visible: 登录按钮 timeout: 30000 label: 等待登录页面加载完成第二层自适应重试。内置状态稳定检测界面没稳定下来就先等失败用例智能重试避免动画或网络抖动造成误判。第三层MCP 工具集。Maestro 控制协议服务器把 14 种测试工具暴露给大模型覆盖设备管理list_devices、start_device、界面交互tap_on、input_text、back、文档查询query_docs、cheat_sheet和流程控制run_flow、run_flow_files。评估系统用 LLM-Judge 给工具调用准确性打分判断阈值 0.8保证 AI 决策可靠。完整工具清单见 maestro-cli/src/test/mcp/full-evals.yaml。省钱与进阶API 调用是真金白银Maestro 设计了三档成本优化用例缓存重复场景直接复用历史分析结果不重复烧 Token。模型分级简单断言走 Claude-3-5-Haiku 这类轻量模型复杂场景再上大模型。增量分析只处理界面变化的区域减少单次请求的输入量。后续路线图上还有三个方向 多模态测试融合能验证语音交互比如断言用户说你好时应用的语音回应。 自修复测试脚本元素变化导致失败时AI 分析新界面并自动更新定位策略。️ 开发者协同平台Maestro Studio 在开发环境里给实时测试建议描述需求即生成用例。下一步从一条断言开始别急着重构整套脚本先挑一个你熟悉的页面给它加一条assertWithAI断言跑一遍。看 AI 怎么描述界面、结论是否靠谱。这条走通了再往登录流程、缺陷检测和双平台场景扩展。【免费下载链接】MaestroPainless E2E Automation for Mobile and Web项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考