EarlGrey is a native iOS UI automation test framework that enables you to write clear, concise tests for iOS applications.
The framework addresses the challenge of flaky UI tests by providing enhanced synchronization features that automatically coordinate with the UI, network requests, and various queues before performing actions. This automatic synchronization ensures the UI reaches a steady state, which increases test stability and repeatability. The tool integrates with XCTest and Xcode's Test Navigator, allowing tests to run directly from Xcode or via command line using xcodebuild.
EarlGrey 1.0 is deprecated in favor of EarlGrey 2.0, which integrates with XCUITest. Developers should evaluate whether to adopt the newer version based on their iOS deployment targets and testing infrastructure. The framework suits teams building native iOS applications who need reliable UI automation testing with minimal flakiness. Those working with modern iOS versions should consider the EarlGrey 2.0 branch instead, as version 1.0 is not maintained for iOS 13 and later.
The project maintains documentation including features, backward compatibility notes, installation guides, and API references. Support resources include a FAQ, known issues documentation, and community channels on Stack Overflow and Google Groups.
