Flutter integration test guideline.md

1. Add test package to pubspec.yaml

• Old:

flutter_driver:
  sdk: flutter

• New:

integration_test:
  sdk: flutter

See (Migrating from flutter_driver)[https://docs.flutter.dev/testing/integration-tests/migration] for more information.

2. Create test_driver and integration_test directory from project root dir

3. Create test_driver/integration_test.dart file:

import 'package:integration_test/integration_test_driver.dart';

Future<void> main() => integrationDriver();

4. Create integration_test/app_test.dart file:

import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';

import 'package:reproduce_issues_test/main.dart' as app;

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  group('end-to-end test', () {
    testWidgets('tap on the floating action button, verify counter',
            (tester) async {
          app.main();
          await tester.pumpAndSettle();

          // Verify the counter starts at 0.
          expect(find.text('0'), findsOneWidget);

          // Finds the floating action button to tap on.
          final Finder fab = find.byTooltip('Increment');

          // Emulate a tap on the floating action button.
          await tester.tap(fab);

          // Trigger a frame.
          await tester.pumpAndSettle();

          // Verify the counter increments by 1.
          expect(find.text('1'), findsOneWidget);
        });
  });
}

main.dart is counter default app since a new Flutter project created.

5. Run integration test

• Old flutter drive test:

flutter drive --driver=test_driver/integration_test.dart --target=integration_test/app_test.dart 

• New flutter test:

flutter test integration_test/app_test.dart

If you run on Web, check this: https://github.com/flutter/flutter/wiki/Running-Flutter-Driver-tests-with-Web

• Download the Chrome driver for that version from driver downloads.
  Starting with M115 the latest Chrome + ChromeDriver releases per release channel (Stable, Beta, Dev, Canary) are available at the Chrome for Testing availability dashboard.
• Start the driver on port 4444:

➜  chromedriver-mac-x64 ./chromedriver --port=4444

If get error about permission (by gatekeeper on macos, use xattr -cr chromedriver before running it)

• Run test:

flutter drive --driver=test_driver/integration_test.dart --target=integration_test/app_test.dart -d web-server

If you run on Safari, check this https://github.com/flutter/flutter/blob/master/docs/contributing/testing/Running-Flutter-Driver-tests-with-Web.md#using-safari.

• Safari driver is located on /usr/bin/safaridriver
• Start the driver on port 4444:

cd /usr/bin/
./safaridriver --port=4444

• Run test:

flutter drive --driver=test_driver/integration_test.dart --target=integration_test/main_tf_test.dart -d web-server --browser-name=ios-safari --web-port=60000