NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #495 most downloaded on pub.dev
A powerful, multiplatform E2E UI testing framework for Flutter apps that overcomes the limitations of integration_test by handling native interactions.
Latest stable
4.11.0
Last release 13 days ago
02 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
166 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
See changelog on pub.dev
See changelog on pub.dev
Selector properties work on iOS (#2030).Your coding agent can read these notes before it upgrades. Set up the MCP server →
Gracefully handle when analytics fail to send. (#2460)
Handle uninstallation of the app after tests finish when using AGP 8.2+. (#2535)
Add --coverage-packages flag to patrol test that specifies which packages should be included in the coverage report. (#2536)
Fix skipping tests with coverage collection enabled. (#2539)
See changelog on pub.dev
$.native.tapAt() (#2053)native.enterText interacting with first EditText regardless of Selector passed (Android-only) (#2072)Fix issues with enterText() . (#2202, #2111)
Add hideKeyboard optional argument to enterText() method.
See changelog on pub.dev
Allow for changing the port when running on iOS (#2027).
To do so, pass test-server-port (default 8081) and app-server-port
(default 8082) to Patrol CLI commands (e.g patrol test)
Fix patrolSetUp() and patrolTearDown() not working in patrol develop (#2023).
This version requires version 2.6.0 of patrol_cli package.
Fix at() , first and last to wait for widget to become visible.
Add isAndroid , isIOS , isWeb and isMacOS getters.
Remove dart:io .
See changelog on pub.dev
xcodebuild's -only-testing option.
Currently iOS only, does not support macOS (#2001)See changelog on pub.dev
See changelog on pub.dev
patrolSetUp() and patrolTearDown(), which are equivalents of
vanilla setUp() and tearDown() but work with Patrol's native automation
and test bundling feature (#1967) (#1721)See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
topics in pubspecSee changelog on pub.dev
This release also depends on patrol_finders v2 and includes its breaking changes.
Give a warm welcome to the new Patrol DevTools Extension!
Patrol DevTools extension allows you to explore the native view hierarchy when
developing tests with patrol develop. Now you can easily see what Android /
iOS views are currently visible and discover their properties so that they can
be used in native selectors like $.native.tap(). You don't have to use any
external tools for that. This is just the beginning, and we plan to add more
features to our extension in the future.
Other changes:
Bump minimum supported Flutter version to 3.16
BREAKING:
bindingType parameter from patrolTest() function. Now only
PatrolBinding is used and it's automatically initialized (#1882)nativeAutomation parameter from patrolTest() function. Now it's
enabled by default (#1882)Remove dependency on integration_test plugin (#1882)
This version requires version 2.3.0 of patrol_cli package.
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
Bump dependencies for Flutter 3.16 and Dart 3.2
Populate topics in pubspec (#1904)
Remove warning about patrol_finders being split from patrol
Allow to disable autogenerating shell completion code in ~/.zshrc (and alike) by setting the PATROL_NO_COMPLETION environment variable
See changelog on pub.dev
group()s (#1634)This version requires version 2.2.0 of patrol_cli package.
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
grantPermissionOnlyThisTime() crashing on Android <11 (#1698)See changelog on pub.dev
nativeAutomation and add message about migration to
patrol_finders (#1670)See changelog on pub.dev
KeyboardBehavior.alternative not automatically try to hide the keyboard
on iOS (#1638)See changelog on pub.dev
andSettle (settleBehavior -> settlePolicy)
(#1622)See changelog on pub.dev
appId parameter missing from NativeAutomator.waitUntilVisible()
(#1611)dart:io when running with
flutter_driver on the Web (#1578)See changelog on pub.dev
PatrolJUnitRunner (#1591)Selector.instance work on iOS (#1569)select[Fine|Coarse]Location() on iOS < 14 (#1564)getNativeViews on iOS (#1553)See changelog on pub.dev
$.native.waitUntilVisible() (#1543)KeyboardBehavior enum to native enterText() methods (#1511)See changelog on pub.dev
BrowserstackPatrolJUnitRunner, which implements a fix to
make tests run on BrowserStack (#1402)See changelog on pub.dev
$.native.openQuickSettings() for iPhones without notch (#1510)See changelog on pub.dev
See changelog on pub.dev
SemanticsHandles
(#1491)See changelog on pub.dev
See changelog on pub.dev
enterText() not working when running with flutter_driver on the web
(#1459)See changelog on pub.dev
This version requires version 2.0.1 of patrol_cli package.
Bump dependencies for Flutter 3.16 and Dart 3.2
Populate topics in pubspec
Read the changelog and migration guide here
Patrol 2.0 is released! 🎉
Patrol 2.0 is released!
integration_test plugin
hereThis version requires version 2.0.0 of patrol_cli package.
Bump minimum supported Flutter version to 3.16 to be compatible with breaking changes in flutter_test
BREAKING :
Remove deprecated andSettle from all PatrolTester and PatrolFinder methods. Use settlePolicy instead (#1892)
The deprecated andSettle method has been removed from all PatrolTester and PatrolFinder methods like tap() , enterText() , and so on. Developers should now use settlePolicy as a replacement, which has been available since June (#1892)
The default settlePolicy has been changed to trySettle (#1892)
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
See changelog on pub.dev
This version requires version 1.0.9 of the patrol package
Add optional telemetry (#1157), (#1182)
Rewrite native test reporting (#1178)
See changelog on pub.dev
which() not taking previous finder(s) into account (#1271)See changelog on pub.dev
See changelog on pub.dev
Fix bug when running on iOS ( .xctestrun file couldn't be found) (#1111)
Make patrol develop command visible (#1104)
See changelog on pub.dev
This version marks the official release of Hot Restart. Learn more here.
Automatically infer iOS-specific build options: scheme and configuration (#1090). The following options were removed from patrol test and patrol develop commands: --scheme , --xcconfig , --configuration
Add patrol build android and patrol build ios commands (#1097)
This version requires version 1.1.4 of the `patrol_cli` package
This version requires version 1.1.4 of the patrol_cli package
Fix "error while disposing" when SIGINT (CTRL+C) is received when waiting for app to start on physical iOS device (#1073)
Fix patrol build crashing (#1074)
Fix App Store warnings about non-public selectors from patrol.framework
patrol.framework
(#1096)Disable forwarding q from patrol develop to flutter attach because it's broken (#1069)
Improve error when patrol develop is missing --target option (#1064)
Fix tap() sometimes not being able to tap on a widget that was previously found and scrolled to by scrollTo()
tap() sometimes not being able to tap on a widget that was previously
found and scrolled to by scrollTo() (#1072)One column per quarter.