Package selection guidance compiled from public package information, community data, and project usage.
patrol_log is a logging package designed for Patrol, a Flutter-native UI testing framework. It enables detailed, structured logging during automated UI tests, helping developers debug test failures and monitor app behavior in real time. Built specifically for Patrol, it integrates seamlessly into the testing workflow across multiple platforms including Android, iOS, Linux, macOS, Web, and Windows. The package supports rich log output with timestamps, test context, and actionable insights, improving test reliability and maintainability. It's ideal for teams practicing robust, end-to-end testing in Flutter applications.
Use cases
Debugging UI test failures
Monitoring test execution flow
Capturing runtime app state during tests
Enhancing test reporting with logs
Integrating with CI/CD pipelines
Key features
Structured logging for UI tests
Real-time log streaming
Cross-platform support
Test context-aware messages
Seamless integration with Patrol framework
Suitable for
Flutter teams using Patrol for UI testing
Developers needing detailed test diagnostics
CI/CD environments requiring traceable test logs
Teams focused on reliable end-to-end testing
Considerations
Requires Patrol framework to be installed
Limited use outside Patrol-based test suites
May increase test execution verbosity
Best used in development and staging environments
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
Patrol
A powerful, multiplatform E2E UI testing framework for Flutter apps that overcomes the limitations of integration_test by handling native interactions. Developed by LeanCode since 2022, battle-tested and shaped by production-grade experience.
Patrol is an open-source framework created and maintained by LeanCode.
However, if your company wants to scale fast and accelerate Patrol’s
adoption, we offer a set of value-added services on top of the core framework.
[!NOTE]
Patrol 4.7.0 adds Swift Package Manager support for iOS and macOS!
If you migrate your project to SPM, a few small setup changes are needed — see the iOS setup guide for details.
Patrol custom finders
Flutter's finders are powerful, but not very intuitive to use.
We took them and made something awesome.
Thanks to Patrol's custom finders, you'll take your tests from this:
Flutter's default integration_test package can't interact with the OS your
Flutter app is running on. This makes it impossible to test many critical
business features, such as:
granting runtime permissions
signing into the app which through WebView or Google Services
The CLI is needed to enable Patrol's native automation feature in integration
tests. It also makes development of integration tests much faster thanks to [Hot
Restart].
To run widget tests, you can continue to use flutter test.
See .github/WORKFLOWS.md for detailed documentation about all GitHub Actions workflows, including test schedules, Flutter versions, and deployment pipelines.