maestro-e2e

适用场景

在以下情况下使用此技能：

• 创建 E2E、UI 或集成测试
• 测试登录、注册或导航流程
• 处理权限对话框（相机、位置、通知）
• 调试测试失败或探索 UI 层级结构
• 编写 Maestro 测试文件（.yaml）

注意事项

处理原生权限对话框时，加载 ./rules/permissions.md 文件，了解平台特定信息。

使用 Flutter 应用时，加载 ./rules/platforms/flutter.md 文件，了解 Semantics 模式。

使用方法

阅读各个规则文件，了解详细说明和代码示例：

核心

• rules/installation.md - 在 macOS、Linux 和 Windows 上安装 Maestro
• rules/test-structure.md - YAML 测试结构、appId、环境变量和流程定义
• rules/commands.md - 40 多个 Maestro 命令的完整参考
• rules/selectors.md - 使用 id、text、index 和匹配器定位元素
• rules/assertions.md - assertVisible、assertNotVisible、assertTrue 和 AI 断言
• rules/interactions.md - tapOn、inputText、scroll、swipe 和手势命令
• rules/permissions.md - iOS 与 Android 的权限配置和对话框处理

平台

• rules/platforms/android.md - Android 专属内容：ADB、权限对话框、模拟器
• rules/platforms/ios.md - iOS 专属内容：自动关闭对话框、模拟器、限制
• rules/platforms/flutter.md - 使用 Semantics 和 identifier 集成 Flutter
• rules/platforms/react-native.md - 使用 testID 和 accessibilityLabel 的 React Native
• rules/platforms/web.md - 使用 Chromium 测试桌面浏览器

进阶

• rules/advanced/parameters.md - 环境变量、外部参数、${} 语法
• rules/advanced/conditions.md - 使用 when: visible、platform 进行条件执行
• rules/advanced/nested-flows.md - 使用 runFlow 命令创建可复用的子流程
• rules/advanced/javascript.md - evalScript、runScript 和 GraalJS 支持
• rules/advanced/waiting.md - extendedWaitUntil、waitForAnimationToEnd
• rules/advanced/repeat-retry.md - 针对不稳定测试的重复和重试模式

补充

• rules/debugging.md - Maestro Studio、层级结构检查、故障排除
• rules/screenshots.md - 屏幕截图、视频录制和视觉证据
• rules/ci-integration.md - GitHub Actions、GitLab CI、Maestro Cloud
• rules/best-practices.md - 语义标识符、原子测试、项目结构