Configures Flutter Driver for app interaction and converts MCP actions into permanent integration tests. Use when adding integration testing to a project, exploring UI components via MCP, or automating user flows with the integration_test package.

Implementing Flutter Integration Tests Contents [Project Setup and Dependencies]( project setup and dependencies) [Interactive Exploration via MCP]( interactive exploration via mcp) [Test Authoring Guidelines]( test authoring guidelines) [Execution and Profiling]( execution and profiling) [Workflow: End to End Integration Testing]( workflow end to end integration testing) [Examples]( examples) Project Setup and Dependencies Configure the project to support integration testing and Flutter Driver extensions. 1. Add required development dependencies to pubspec.yaml : 2. Enable the Flutter Driver extension in your application entry point (typically lib/main.dart or a dedicated lib/main test.dart ): Import package:flutter driver/driver extension.dart . Call enableFlutterDriverExtension(); before runApp() . 3. Add Key parameters (e.g., ValueKey('login button') ) to critical widgets in the application code to ensure reliable targeting during tests. Interactive Exploration via MCP Use the Dart/Flutter MCP server tools to interactively explore and manipulate the application state before writing static tests. Launch : Execute launch app with target: "lib/main test.dart" to start the application and acquire the DTD URI. Inspect : Execute get widget tree to discover available Key s, Text nodes, and widget Type s. Interact : Execute tap , enter text , and scroll to simulate user flows. Wait : Always execute waitFor or verify state with get health when navigating or triggering animations. Troubleshoot Unmounted Widgets : If a widget is not found in the tree, it may be lazily loaded in a SliverList or ListView . Execute scroll or scrollIntoView to force the widget to mount before interacting with it. Test Authoring Guidelines Structure integration tests using the flutter test API paradigm. Create a dedicated integration test/ directory at the project root. Name all test files using the <name test.dart convention. Initialize the binding by calling IntegrationTestWidgetsFlutterBinding.ensureInitialized(); at the start of main() . Load the application UI using await tester.pumpWidget(MyApp()); . Trigger frames and wait for animations to complete using await tester.pumpAndSettle(); after interactions like tester.tap() . Assert widget visibility using expect(find.byKey(ValueKey('foo')), findsOneWidget); or findsNothing . Scroll to specific off screen widgets using await tester.scrollUntilVisible(itemFinder, 500.0, scrollable: listFinder); . Conditional Logic for Legacy flutter driver : If maintaining or migrating legacy flutter driver tests, use driver.waitFor() , driver.waitForAbsent() , driver.tap() , and driver.scroll() instead of the WidgetTester APIs. Execution and Profiling Execute tests using the flutter drive command. Require a host driver script located in test driver/integration test.dart that calls integrationDriver() . Conditional Execution Targets: If testing on Chrome: Launch chromedriver port=4444 in a separate terminal, then run: flutter drive driver=test driver/integration test.dart target=integration test/app test.dart d chrome If testing headless web: Run with d web server . If testing on Android (Local): Run flutter drive driver=test driver/integration test.dart target=integration test/app test.dart . If testing on Firebase Test Lab (Android): 1. Build debug APK: flutter build apk debug 2. Build test APK: ./gradlew app:assembleAndroidTest 3. Upload both APKs to the Firebase Test Lab console. Workflow: End to End Integration Testing Copy and follow this checklist to implement and verify integration tests. [ ] Task Progress: Setup [ ] Add integration test and flutter test to pubspec.yaml . [ ] Inject enableFlutterDriverExtension() into the app entry point. [ ] Assign ValueKey s to target widgets. [ ] Task Progress: Exploration [ ] Run launch app via MCP. [ ] Map the widget tree using get widget tree . [ ] Validate interaction paths using MCP tools ( tap , enter text ). [ ] Task Progress: Authoring [ ] Create integration test/app test.dart . [ ] Write test cases using WidgetTester APIs. [ ] Create test driver/integration test.dart with integrationDriver() . [ ] Task Progress: Execution & Feedback Loop [ ] Run flutter drive driver=test driver/integration test.dart target=integration test/app test.dart . [ ] Feedback Loop : Review test output If PumpAndSettleTimedOutException occurs, check for infinite animations If widget not found, add scrollUntilVisible Re run test until passing. Examples Standard Integration Test ( integration test/app test.dart ) Host Driver Script ( test driver/integration test.dart ) Performance Profiling Driver Script ( test driver/perf driver.dart ) Use this driver script if you wrap your test actions in binding.traceAction() to capture performance metrics.

flutter-add-integration-test