LiveTestWidgetsFlutterBinding class

A variant of TestWidgetsFlutterBinding for executing tests on a device, typically via flutter run, or via integration tests. This is intended to allow interactive test development.

This is not the way to run a remote-control test. To run a test on a device from a development computer, see the flutter_driver package and the flutter drive command.

When running tests using flutter run, consider adding the --use-test-fonts argument so that the fonts used match those used under flutter test. (This forces all text to use the "Ahem" font, which is a font that covers ASCII characters and gives them all the appearance of a square whose size equals the font size.)

This binding overrides the default SchedulerBinding behavior to ensure that tests work in the same way in this environment as they would under the AutomatedTestWidgetsFlutterBinding. To override this (and see intermediate frames that the test does not explicitly trigger), set framePolicy to LiveTestWidgetsFlutterBindingFramePolicy.fullyLive. (This is likely to make tests fail, though, especially if e.g. they test how many times a particular widget was built.) The default behavior is to show pumped frames and a few additional frames when pointers are triggered (to animate the pointer crosshairs).

This binding does not support the EnginePhase argument to pump. (There would be no point setting it to a value that doesn't trigger a paint, since then you could not see anything anyway.)

See TestWidgetsFlutterBinding for a list of mixins that must be provided by the binding active while the test framework is running.