patrol 2.0.0-dev.2

patrol: ^2.0.0-dev.2 copied to clipboard

• Fix test bundling not working on physical iOS devices (works only with patrol test --release) (#1303)

• Fix test label (red text in the upper left corner) of the current test being always test_bundle.dart (#1306)

• Backport changes from master (#1293)

• Support test bundling on iOS (#1236)

• Fix a small typo in logs (#1229)

• Support test bundling on Android (#1205) (#1220) (#1221)

• Fix build with Android Gradle Plugin v8 (#1276)

• Fix which() not taking previous finder(s) into account (#1271)

• Fix crashing when using Gradle 8 (#1262)

• Add support for Flutter 3.10 (#1254)

This version marks the official release of Hot Restart. Learn more here.

This version requires version 1.1.4 of the patrol_cli package

• Rewrite native test reporting (#1178)

• Fix App Store warnings about non-public selectors from patrol.framework (#1096)

• Fix tap() sometimes not being able to tap on a widget that was previously found and scrolled to by scrollTo() (#1072)

• Add preliminary support for patrol develop. Requires version 1.0.6 of patrol_cli.

• Update small typo in pub.flutter-io.cn listing (#1034)

• Fix build of example app for Android when building on Windows (#998)

• Remove unnecessary dependency on vm_service (#986)

• Fix PATROL_WAIT (passed through --wait argument to patrol test) preventing frames from being pumped (#959)
• Fix tapping on notification crashing on iPads (#963)
• Remove no longer functional methods from PatrolBinding (#970)

• Make NativeAutomator.enterTextByIndex() have a default timeout, just like NativeAutomator.enterText() (#943)

  Documentation of these 2 methods has also been updated to explain the behavior in more detail.

• Use automated publishing with GitHub Actions on pub.flutter-io.cn (#953) (#955) (#956) (#957)

• Fix IndexOutOfBounds exception when waiting for native views on Android (#939)
• Fix flutter run not working in example app because of an error in Gradle build file (#940)

• Patrol 1.0 is released!

• Minor documentation fixes (#912)

• Remove unnecessary dependency on json_serializable and json_annotation (#904)

• Fix crash Instrumentation run failed due to Process crashed on Android (#902)

• Improve error message when trying to use NativeAutomator, but it's not initialized (#856)

• Add GitHub Actions showing to run Patrol tests natively on both Android and iOS (#747, #752)
• Add PatrolTestRunner class, which should be used instead of FlutterTestRunner in MainActivityTest.java file (#754)

• Strip out code that App Store is angry about by default in release iOS builds (#727)

• Make it possible to change LiveTestWidgetsFlutterBindingFramePolicy in patrolTest() (#716)

• Add support for test label overlay in PatrolBinding (#701)

• Migrate to lite Protocol Buffers and gRPC to avoid conflicts with Firebase on Android (#688)

• Fix Android dependencies leaking into dependent apps (#683)

• Fix breaking iOS builds by migrating off CGVectorMake(), which is unavailable in Swift (#676)

• Fix breaking iOS builds by setting minimum iOS version to 13.0 (#674)

• Allow for running as native Android/iOS instrumented test (Patrol Next) (#646, #671)

• Add NativeAutomator.swipe() to enable simple swiping (#669)

• Breaking: Remove PatrolTester.log() - it did not fit in there and was rarely used (#665)
• Breaking: Remove PatrolTesterConfig.appName - it's only usage was in PatrolTester.log(), and since it was removed, this field is removed as well (#665)

• Breaking: Change signature of PatrolTester.pumpAndSettle() method to use named arguments (#657)
• Fix PatrolTester.dragUntilVisible() not calling first on its Finder view parameter (#656)

• Make it possible to configure loggers of NativeAutomator and HostAutomator (#644)
• Throw PatrolFinderException when PatrolFinder.text fails (#644)

• Revamp configuration of testers, letting for more granural setup (#640):
  • Rename PatrolTestConfig to PatrolTesterConfig
  • Introduce NativeAutomatorConfig
  • Introduce HostAutomatorConfig
• Introduce HostAutomator.run() method, which lets you run programs on your computer from within your Flutter integration tests (#630)

• Fix minor bug with custom binding initialization (#636)

• Add patrolIntegrationDriver, which extends the default integrationDriver with cool features like taking screenshots. More features enabled by patrolIntegrationDriver are coming soon! (#593)
• Warn when package name and bundle identifier is not set in PatrolTestConfig (#591)

• Add PatrolFinder.which() (#571)

• Add andSettle param to PatrolFinder.scrollTo() (#501)
• Add more integration tests to the example app (#491)

In this release, we've focused on stability, reliability, and reducing flakiness.

• Add timeouts when interacting with native UI (#437)
• Implement isPermissionDialogVisible() method (#448)

• Add useBinding flag to patrolTest (#419)

• Breaking: Rename NativeAutomator.forTest() constructor to an unnamed constructor (#410)
• Add useBinding flag to NativeAutomator constructor. Defaults to true, which means that PatrolBinding is initialized during the constructor call (#410)
• Fix timeout argument to NativeAutomator being ignored (#410)

• Make $() accept a Widget as an argument (#402)

• Remove the unused appId argument from most methods (#399)
• Breaking: Rename getNativeWidgets() to getNativeViews() (#399)

• Fix handling permission prompts now working in some edge cases (#383)

• Fix package score on pub.flutter-io.cn (#375)

• Implement enabling and disabling cellular on iOS (#371)

• Make openApp() open the app under test when no appId is passed (#338)
• Implement enableWifi(), disableWifi(), and openRecentApps() on iOS (#338)
• Completely rewrite communication with native automation servers (#338)

• Implement enabling and disabling dark mode on iOS (#345)

• Fix spelling of "cellular" (was "celluar") (#336)
• Fix a typo in docs (#337)
• Fix README and docs mentioning the removed Patrol class (#349)

• A bunch of post-release fixes (#330)

• Stop re-exporting package:flutter_test (#308)

• Don't require host and port to be defined in patrol.toml or passed in as command-line arguments (#301)
• Rename Patrol to NativeAutomator and embed it in PatrolTester (#297)
• Print cleaner, more readable logs when native action fails (#295)

• Fix handling native permission request dialogs on older Android versions (#260)
• Populate homepage field in pubspec.yaml (#254)

• Rename to patrol (#258)
• Remove sleep from MaestroTestConfig. Use the new --wait argument available in the CLI (#251)

• Bring more functionality to iOS (#246)
  • Implement native tap(), enterText(), and handlePermission() methods on iOS
  • Maestro.forTest(): add optional packageName and bundleId arguments

• Add support for handling native permission request dialogs on Android (#232)
• Attempt to fix a weird issue with scroll not working in some rare cases (#237)
• Re-export package:flutter_test

• Make MaestroFinder.text getter more robust

• Fix a problem with StateError being thrown when MaestroTester.dragUntilVisible found more than 1 finder after dragging to it (#228)

• Some fixes to the scrolling and dragging

• Set minimum Dart version to 2.17 (#224)

• Revamp scrolling and dragging (#217)

  • New MaestroTester.dragUntilExists()
  • Fixed MaestroTester.dragUntilVisible()'s behavior
  • New MaestroTester.scrollUntilExists method
  • New MaestroTester.scrollUntilVisible method
  • MaestroFinder.dragTo was renamed to MaestroFinder.scrollTo and now also scrolls to widgets that are not yet built (e.g in a lazily-built ListView)

• Allow for more fine-grained control over timeouts (#191)

  • settleTimeout, which is used for MaestroTester.pumpAndSettle (which forwards it to WidgetTester.pumpAndSettle)
  • existsTimeout, which is used for MaestroFinder.waitUntilExists
  • visibleTimeout (previously findTimeout), which is used by MaestroFinder.waitUntilVisible (which is then used internally by MaestroFinder.tap() and MaestroFinder.enterText().

• Downgrade package:freezed to v1 beacuse customer project is not able to update to v2

• Create MaestroTestConfig class which is accepted by maestroTest function. Use it to share common configuration across all tests
• Upgrade package:freezed to v2. Dependent projects should also make this change

MaestroFinder:

• Rename visible method to waitUntilVisible
• Add waitUntilExists method
• Add exists getter
• Add visible getter

• Add MaestroFinder.dragTo
• Remove unused MaestroTester.drag and MaestroTester.dragFrom

• Convert MaestroFinder.visible getter to a method, which now also takes a timeout
• Rename MAESTRO_ARTIFACT_PATH environment variable to `MAESTRO_CACHE
• Fix MaestroTester.dragUntilVisible not waiting for the scrollable to appear
• Fix MaestroFinder.allCandidates returning incorrect results

• Throw MaestroFinderFoundNothingException when [MaestroFinder.visible] doesn't find any widget during [MaestroTester.findTimeout]

MaestroFinder:

• Now tap() and enterText() wait for the widget to become visible. The timeout can be configured by setting findTimeout in maestroTest()
• Remove index parameter from tap() and enterText(). The new way to select the widget to be tapped is to use at() before tapping. Same goes for entering text
• Add bool andSettle parameter to maestroTest function. This lets you globally configure whether to call pumpAndSettle after actions such as tap() or enterText()
• Refactor MaestroTester.dragUntilVisible to be simpler to use
• Rename withDescendant() to containing()

Native:

• Make Maestro.openNotifications() and Maestro.openQuickSettings() more robust

• Make it possible to pass Flutter's Finder to $
• Make MaestroFinder.first, MaestroFinder.last, MaestroFinder.at() return MaestroFinder, not Finder

• Improve selector engine:

  • Make it possible to pass a Key as matching to MaestroTester.call(dynamic matching) and MaestroFinder.$(dynamic matching)

• Add sleep parameter for maestroTest method

• Make WidgetTester's forwarded methods in MaestroTester accept less arguments

• Add more in-code documentation

• Improve selector engine:

  • Make it possible to pass a MaestroFinder as matching to MaestroTester.call(dynamic matching) and MaestroFinder.$(dynamic matching)
  • Fix a bug which caused chaining MaestroFinders (e.g $(Scaffold).$(Container).$(#someText)) to not work.

• Add more in-code documentation and improve README

• Add selector engine

• Introduce Selector class, which can be passed into Maestro.tap(selector).

• Add more platform functionality:

  • Maestro.enableWifi() and Maestro.disableWifi()
  • Maestro.enableCellular() and Maestro.disableCellular()
  • Maestro.enableDarkMode() and Maestro.disableDarkMode()
  • Maestro.getNotifications(), Maestro.getFirstNotification(), and Maestro.tapOnNotification(int index)

• Make Maestro.forTest() automatically call IntegrationTestWidgetsFlutterBinding.ensureInitialized()

• Fix many smaller issues

• Allow for running on many devices simultaneously
• Rename class Automator to Maestro
• Simpified test-side initialization. Now all you need is Maestro.forTest()
• Simpified driver-side initialization. Now all you need is Maestro.forDriver()

• Add support for enabling/disabling Bluetooth

• Be more noisy when an error occurs

• Fix minor logging bug

• Add basic means of controlling platform-native Widgets (TextView, EditText, and Button on Android). This also applies to WebView.
• Add enabling and disabling of Wi-Fi, Cellular, and Night Mode
• Improve stability

• Set minimum Dart version to 2.16
• Fix links to package:leancode_lint in README

• Update broken link in README.

• Update README

• Rename from maestro to maestro_test

• Split maestro and maestro_cli into separate packages

• Initial version