flutter/dev/automated_tests/flutter_test/README.md

The files in this directory are used as part of tests in the
`flutter_tools` package. Some are here because here these tests need a
`pubspec.yaml` that references the flutter framework (which is
intentionally not true of the `flutter_tools` package). Others are
here mostly out of peer pressure.
Make it possible to run tests live on a device (#3936) This makes it possible to substitute 'flutter run' for 'flutter test' and actually watch a test run on a device. For any test that depends on flutter_test: 1. Remove any import of 'package:test/test.dart'. 2. Replace `testWidgets('...', (WidgetTester tester) {` with `testWidgets('...', (WidgetTester tester) async {` 3. Add an "await" in front of calls to any of the following: * tap() * tapAt() * fling() * flingFrom() * scroll() * scrollAt() * pump() * pumpWidget() 4. Replace any calls to `tester.flushMicrotasks()` with calls to `await tester.idle()`. There's a guarding API that you can use, if you have particularly complicated tests, to get better error messages. Search for TestAsyncUtils. 2016-05-16 19:53:13 +00:00			`The files in this directory are used as part of tests in the`
Upgrade to the most recent test package. (#11526) Also, add tests to verify that our coverage is actually being tested! 2017-08-04 23:33:38 +00:00			`flutter_tools` package. Some are here because here these tests need a
Make it possible to run tests live on a device (#3936) This makes it possible to substitute 'flutter run' for 'flutter test' and actually watch a test run on a device. For any test that depends on flutter_test: 1. Remove any import of 'package:test/test.dart'. 2. Replace `testWidgets('...', (WidgetTester tester) {` with `testWidgets('...', (WidgetTester tester) async {` 3. Add an "await" in front of calls to any of the following: * tap() * tapAt() * fling() * flingFrom() * scroll() * scrollAt() * pump() * pumpWidget() 4. Replace any calls to `tester.flushMicrotasks()` with calls to `await tester.idle()`. There's a guarding API that you can use, if you have particularly complicated tests, to get better error messages. Search for TestAsyncUtils. 2016-05-16 19:53:13 +00:00			`pubspec.yaml` that references the flutter framework (which is
Upgrade to the most recent test package. (#11526) Also, add tests to verify that our coverage is actually being tested! 2017-08-04 23:33:38 +00:00			intentionally not true of the `flutter_tools` package). Others are
			`here mostly out of peer pressure.`