PackageTrack
Sign in Get early access

patrol_finders

Streamlined, high-level API on top of flutter_test.

3.6.0 497K downloads/mo #515 most downloaded on pub.dev leancodepl/patrol

What this package is like to depend on

Last release 1 months ago

09 Jul 2026

Ships fairly regularly

a new release about every 6 weeks

Nearly every release is documented

notes for 28 of 28 stable releases

Nothing withdrawn

no release was ever pulled

3 years old

31 releases · first in 2023

8 releases in the last 12 months

see the full history below

Release timeline

31 releases · Aug 2023 to Jul 2026
2024 2025 2026
Release Pre-release

Releases

latest 31
  1. 3.6.0 09 Jul 2026
    Release notes
    • Bump patrol_log to ^0.10.0.
    Open source →
    Release notes
    • Improve patrol test error messaging when compatibility check fails, added same compatibility check and error messaging to patrol build command (#2597)

    • Improve patrol update messaging by showing incompatibility warning when applicable, sharing compatibility table (#2579)

    • Add ability to quit the patrol develop process by pressing q on the keyboard (#2577)

    • Fix issue with reading logs on iOS devices in release. (#2569)

    • Add --ios flag to patrol test that specifies the iOS version to use. (#2540)

    • Bump custom_lint to 0.7.0 and leancode_lint to 14.3.0 . (#2574)

    • Display the name of the default device instead of its ID. (#2581)

    • Do not pass flavor as dart-define when building. (#2636)

    • Bump vm_service dependency to 15.0.0 (#2636)

    Open source →
  2. 3.5.0 03 Jun 2026
    Release notes
    • Fix issues with enterText(). (#2202, #2111)
    • Add hideKeyboard optional argument to enterText() method.
    Open source →
    Release notes
    • Add PATROL_ANALYTICS_ENABLED environment variable to disable analytics. (#2483)

    • Enable analytics by default. (#2483)

    Open source →
  3. 3.4.0 15 May 2026
    Release notes
    • Fix at(), first and last to wait for widget to become visible.
    • Add isAndroid, isIOS, isWeb and isMacOS getters.
    • Remove dart:io.
    Open source →
    Release notes
    • Add support for the patrol_log package. (#2387)

    This version requires version 3.13.0 of patrol package.

    Open source →
  4. 3.3.0 14 May 2026
    Release notes
    • Bump patrol_log to ^0.9.0.
    Open source →
    Release notes
    • Add clear-permissions flag on ios commands. (#2367)

    This version requires version 3.12.0 of patrol package.

    Open source →
  5. 3.2.0 25 Mar 2026
    Release notes
    • Bump patrol_log to ^0.8.0.
    Open source →
    Release notes
    • Add code coverage collection support (#2294)

    This version requires version 3.11.0 of patrol package.

    Open source →
  6. 3.1.0 09 Feb 2026
    Release notes
    • Bump patrol_log to 0.7.0.
    Open source →
    Release notes
    • Add tags and exclude-tags . (#2286)

    • Run flutter build apk --config-only during android build.(#2293)

    This version requires version 3.10.0 of patrol package.

    Open source →
  7. 3.0.0 08 Dec 2025
    Release notes
    • Bump patrol_log to 0.6.0.
    Open source →
    Release notes
    • Breaking: Use java version from flutter doctor
    Open source →
  8. 3.0.0-dev.1 01 Dec 2025 pre-release

    Nothing published for this version

  9. 2.9.0 15 Jul 2025
    Release notes
    • Bump leancode_lint to 17.0.0. (#2681)
    • Bump minimum Dart SDK to version 3.8.0 (#2681)
    Open source →
  10. 2.8.2 06 May 2025
    Release notes
    • Add alignment argument to tap(), longPress(), enterText(), scrollTo(), dragUntilVisible() and scrollUntilVisible() methods. (#2584)
    Open source →
  11. 2.7.2 26 Mar 2025
    Release notes
    • Remove PatrolWidgetTester class. (#2570)
    Open source →
  12. 2.7.1 26 Mar 2025
    Release notes
    • Bump Gradle version in the example app so it's possible to build them on the latest JDK 23 (#2503)
    • Bump custom_lint to 0.7.0 and leancode_lint to 14.3.0. (#2574)
    • Fix $.enterText() issues (#2570)
    Open source →
  13. 2.7.1-dev.1 23 Mar 2025 pre-release

    Nothing published for this version

  14. 2.7.0 17 Jan 2025
    Release notes
    • Add alignment parameter to waitUntilVisible in order to improve visibility check on Row and Column widgets. (#2464)
    • Add isVisibleAt method to check if a widget is visible at a given alignment in case visible fails. (#2464)
    • Remove exception from StepEntry. When it was too long, it caused crash because of badly formed JSON. (#2481)
    • Bump patrol_log version.
    Open source →
    Release notes
    • Add support for custom flutter commands (#2124).
    Open source →
  15. 2.6.0 23 Dec 2024
    Release notes
    • Patch enterText into same field twice. (#2461)
    • Bump patrol_log version.
    Open source →
    Release notes

    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 )

    Do not open devtools by default when patrol develop is executed (#2048).

    This version requires version 3.4.0 of patrol package.

    Open source →
  16. 2.5.1 04 Dec 2024
    Release notes
    • Disable printing logs in nested waitUntilVisible and waitUntilExists calls.
    Open source →
  17. 2.5.0 22 Nov 2024
    Release notes
    • Update patrol_log.
    Open source →
    Release notes
    • Allow for defining a custom test file suffix (#2009)

    • Fix opening devtools on Windows (#2011)

    Open source →
  18. 2.4.0 20 Nov 2024
    Release notes
    • Wrap actions on finders with patrol logs.
    Open source →
    Release notes
    • Add support for running patrol tests on macOS (alpha) (#1847)

    • Set --destination-timeout 1 when calling xcodebuild test-without-building to fail faster in error conditions (#1979)

    • Set --only-testing RunnerUITests/RunnerUITests to ignore other XCTest that might be present (#1991)

    Open source →
  19. 2.3.0 13 Nov 2024
    Release notes
    • Add option to disable printing patrol logs. Default value is disabled.
    Open source →
    Release notes
    • Add support for Patrol 3.0 and its DevTools extension (#1829)
    • Automatically open DevTools when running patrol develop . This behavior can be disabled by passing --no-open-devtools flag.

    This version requires version 3.0.0 of patrol package.

    Open source →
  20. 2.2.0 08 Nov 2024
    Release notes
    • Use patrol_log in PatrolTester methods.
    Open source →
    Release notes
    • Add support for group() (#1634)

    • Adjust generated test_bundle.dart to not depend on gRPC contracts (#1681)

    This version requires version 2.3.0 of patrol package.

    Open source →
  21. 2.2.0+1 08 Nov 2024
    Release notes
    • Bump patrol_log version.
    Open source →
  22. 2.1.3 21 Oct 2024
    Release notes
    • Bump min Flutter SDK to 3.24.0 and Dart SDK to 3.5.0 (#2371)
    Open source →
    Release notes
    • Add migration message due to release of patrol_finders
    Open source →
  23. 2.1.2 23 May 2024
    Release notes
    • Adjust pumpWidget to new flutter_test API.
    • Bump min Flutter SDK to 3.22
    Open source →
    Release notes
    • Fix .xctestrun file not being found when the RunnerUITests targe uses XCTestPlans (#1636)
    Open source →
  24. 2.1.1 23 May 2024
    Release notes
    • Revert: Adjust pumpWidget to new flutter_test API.
    Open source →
    Release notes
    • Change the location of iOS test reports to build/ios_results with timestamp appended. The path to the report is printed after patrol test exits (#1623)
    Open source →
  25. 2.1.0 20 May 2024
    Release notes
    • Adjust pumpWidget to new flutter_test API.
    Open source →
    Release notes
    • Add --no-generate-bundle flag (#1565)

    • Don't check for patrol_cli updates on CI (#1557)

    Open source →
  26. 2.0.3-dev.1 13 May 2024 pre-release

    Nothing published for this version

  27. 2.0.2 16 Feb 2024
    Release notes
    • Add registering text input. (#2111)
    Open source →
    Release notes
    • Fix --release not working when building/running on Android (#1484)
    Open source →
  28. 2.0.1 15 Nov 2023
    Release notes
    • Bump dependencies for Flutter 3.16 and Dart 3.2
    • Populate topics in pubspec
    Open source →
    Release notes
    • Support for fix for WebViews on modern Android versions (#1398)

    • Implement a proper fix for tests failing when using native automation on Android + Flutter 3.10 (#1398). This replaces a workaround implemented in #1352.

    This version requires version 2.0.1 of patrol package.

    Open source →
  29. 2.0.1+1 16 Nov 2023
    Release notes
    • Add screenshots to pubspec.yaml (#1917)
    Open source →
  30. 2.0.0 14 Nov 2023
    Release notes
    • 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)
    Open source →
    Release notes

    Patrol 2.0 is released!

    • Read the changelog and migration guide here

    • Read the article about how Patrol 2.0 fixes the integration_test plugin here

    This version requires version 2.0.0 of patrol package.

    Open source →
  31. 1.0.0 10 Aug 2023
    Release notes
    • Initial release as a standalone package (#1606)
    Open source →
    Release notes
    • Patrol 1.0 is released!
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive