EarlGrey

EarlGrey 是一个本机 iOS UI 自动化测试框架，它使您能够编写清晰、简洁的测试。

使用 EarlGrey 框架，您可以访问增强的同步功能。EarlGrey 会自动与 UI、网络请求和各个队列同步；但如果需要，仍允许您手动实现自定义的计时。

EarlGrey 的同步功能有助于确保在执行操作之前 UI 处于稳定状态。这极大地提高了测试的稳定性和可重复性。

EarlGrey 与 XCTest 框架协同工作，并集成到 Xcode 的测试导航器中，因此您可以直接从 Xcode 或命令行（使用 xcodebuild）运行测试。

入门

用户 EarlGrey 文档位于 EarlGrey/docs 文件夹中。要开始，请查看 EarlGrey 特性，检查向后兼容性，然后使用您的测试目标安装/运行 EarlGrey。配置完成后，查看 EarlGrey API 并开始编写您的测试。

• 特性
• 向后兼容性
• 安装和运行
• API
• 速查表

获取帮助

如果您需要帮助，有几种资源可供使用。首先检查 常见问题解答（FAQ）。在阅读了 FAQ 之后，如果您还有更多问题，请参阅 已知问题。您可以在 stackoverflow.com 使用 #earlgrey 标签 提出更具体的问题。您还可以在我们的 Google 论坛 上开始新的讨论，或者请求加入我们的 Slack 频道。

• FAQ - 常见问题解答
• IFAQ - 不常见问题解答
• 已知问题
• Stack Overflow
• Slack
• Google 论坛

分析

为了优先级和改进 EarlGrey，框架会收集使用数据并将其上传到 Google Analytics。更具体地说，框架会收集 Bundle ID、测试类名称 和 测试方法名称 的 MD5 哈希。这些信息使我们能够衡量使用量。有关我们的分析收集的更多详细信息，请参阅包含实现详细信息的 GREYAnalytics.m 文件。如果用户希望，他们可以在他们的测试的 - (void)setUp 方法中禁用分析配置设置以选择退出

在 Objective-C 中

// Disable analytics.
[[GREYConfiguration sharedInstance] setValue:@(NO) forConfigKey:kGREYConfigKeyAnalyticsEnabled];

在 Swift 中

// Disable analytics.
GREYConfiguration.sharedInstance().setValue(false, forConfigKey: kGREYConfigKeyAnalyticsEnabled)

对于贡献者

请在做出任何贡献之前，确保您已遵循CONTRIBUTING.md中的指南。

设置 EarlGrey 项目

1. 从 GitHub 克隆 EarlGrey 代码库

git clone https://github.com/google/EarlGrey.git

2. 您已克隆 EarlGrey 代码库后，使用 setup-earlgrey.sh 下载所有依赖。
3. 脚本成功完成后，打开 EarlGrey.xcodeproj 并确保所有目标都能构建。
4. 现在您可以使用 EarlGrey.xcodeproj 来更改框架。

添加并运行测试

单元测试

要为 EarlGrey 添加单元测试，请使用位于 Tests/UnitTests 的 UnitTests.xcodeproj。要运行所有单元测试，请选择 UnitTests 方案并按 Cmd+U。

功能测试

要为 EarlGrey 添加功能测试，请使用位于 Tests/FunctionalTests 的 FunctionalTests.xcodeproj。要运行所有功能测试，请选择 FunctionalTests 方案并按 Cmd+U。