AI TOOLS RADAR
全部 Skills / DHRUVANBHALARA
dhruvanbhalara/skills

flutter-add-integration-test

Use when creating end-to-end integration tests, automating user journey tests, or running tests on real devices and emulators.

查看源码

使用方法

  1. 复制安装命令，在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/dhruvanbhalara/skills --skill flutter-add-integration-test

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Contents

Project Setup

  1. Add required development dependencies to pubspec.yaml:
bash
    flutter pub add 'dev:integration_test:{"sdk":"flutter"}'
    flutter pub add 'dev:flutter_test:{"sdk":"flutter"}'
  1. Create directory structure:
    project_root/
    ├── integration_test/
    │   └── app_test.dart          # Test cases
    └── test_driver/
        └── integration_test.dart  # Host driver script
  1. Create the host driver script at test_driver/integration_test.dart:
dart
    import 'package:integration_test/integration_test_driver.dart';

    Future<void> main() => integrationDriver();
  1. Add ValueKeys to critical widgets in production code for reliable targeting:
dart
    FloatingActionButton(
      key: const ValueKey('increment_fab'),
      onPressed: _increment,
      child: const Icon(Icons.add),
    )

Test Authoring

  • Initialize the binding at the top of main(): this replaces the default test binding.
  • Load the full application with tester.pumpWidget(const MyApp()).
  • Use tester.pumpAndSettle() after every interaction to wait for animations and async operations.
  • Assert widget visibility using expect(find.byKey(ValueKey('foo')), findsOneWidget).
  • Scroll to off-screen widgets using tester.scrollUntilVisible(finder, 500.0).

Test File Structure

dart
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';
import 'package:my_app/main.dart';

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  group('End-to-end test', () {
    testWidgets('complete user flow', (tester) async {
      // Load full app
      await tester.pumpWidget(const MyApp());

      // Interact with widgets
      await tester.tap(find.byKey(const ValueKey('login_button')));
      await tester.pumpAndSettle();

      // Assert navigation happened
      expect(find.byType(HomePage), findsOneWidget);
    });
  });
}

Execution Targets

Choose the execution method based on target platform:

Local Device (Android/iOS)

bash
flutter test integration_test/

For iOS, when running under the default Swift Package Manager (SPM) integration (Flutter 3.44+), ensure you run package resolution first:

bash
xcodebuild -resolvePackageDependencies -workspace ios/Runner.xcworkspace -scheme Runner

Chrome (Web)

bash
# Terminal 1: Start ChromeDriver
chromedriver --port=4444

# Terminal 2: Run tests
flutter drive \
  --driver=test_driver/integration_test.dart \
  --target=integration_test/app_test.dart \
  -d chrome

Headless Web

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

Firebase Test Lab (Android)

bash
# 1. Build debug APK
flutter build apk --debug

# 2. Build instrumentation test APK
pushd android && ./gradlew app:assembleAndroidTest && popd

# 3. Upload both APKs to Firebase Test Lab via console or gcloud:
gcloud firebase test android run \
  --type instrumentation \
  --app build/app/outputs/flutter-apk/app-debug.apk \
  --test build/app/outputs/apk/androidTest/debug/app-debug-androidTest.apk

Performance Profiling

Wrap test actions in binding.traceAction() to capture performance timelines:

dart
void main() {
  final binding = IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  testWidgets('scrolling performance', (tester) async {
    await tester.pumpWidget(const MyApp());

    await binding.traceAction(() async {
      final listFinder = find.byType(Scrollable);
      await tester.fling(listFinder, const Offset(0, -500), 10000);
      await tester.pumpAndSettle();
    }, reportKey: 'scrolling_timeline');
  });
}

Performance Profiling Driver

Use this driver to capture and write timeline data:

dart
import 'package:flutter_driver/flutter_driver.dart' as driver;
import 'package:integration_test/integration_test_driver.dart';

Future<void> main() {
  return integrationDriver(
    responseDataCallback: (data) async {
      if (data != null) {
        final timeline = driver.Timeline.fromJson(
          data['scrolling_timeline'] as Map<String, dynamic>,
        );
        final summary = driver.TimelineSummary.summarize(timeline);
        await summary.writeTimelineToFile(
          'scrolling_timeline',
          pretty: true,
          includeSummary: true,
        );
      }
    },
  );
}

CI/CD Integration

GitHub Actions Workflow

yaml
- name: Run integration tests
  uses: reactivecircus/android-emulator-runner@v2
  with:
    api-level: 33
    script: flutter test integration_test/ --flavor dev
  • Use reactivecircus/android-emulator-runner for Android emulator.
  • Collect test result artifacts with actions/upload-artifact.
  • For web, run chromedriver as a service and test with -d chrome.

Common Pitfalls

ErrorCauseFix
PumpAndSettleTimedOutExceptionInfinite animation (e.g., CircularProgressIndicator)Use pump() instead, or dismiss the loading state
Widget not foundLazy-loaded in SliverList or ListViewCall scrollUntilVisible() before interacting
Test hangsNetwork call in production codeMock HTTP client or use --dart-define to bypass
No host driver specifiedMissing test_driver/integration_test.dartCreate the host driver file

Workflow: Adding an Integration Test

Task Progress

  • [ ] Step 1: Add integration_test and flutter_test to dev_dependencies.
  • [ ] Step 2: Assign ValueKeys to target widgets in production code.
  • [ ] Step 3: Create integration_test/app_test.dart with binding initialization.
  • [ ] Step 4: Create test_driver/integration_test.dart with integrationDriver().
  • [ ] Step 5: Write test cases: load app, interact, assert.
  • [ ] Step 6: Choose execution target:
  • Local device: flutter test integration_test/
  • Chrome: flutter drive ... -d chrome
  • Firebase Test Lab: build + upload APKs
  • [ ] Step 7: Feedback Loop:
  • If PumpAndSettleTimedOutException → check for infinite animations.
  • If widget not found → add scrollUntilVisible.
  • Re-run until all tests pass.

Examples

Standard Integration Test

dart
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';
import 'package:my_app/main.dart';

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  group('Counter app', () {
    testWidgets('tap FAB, verify counter increments', (tester) async {
      await tester.pumpWidget(const MyApp());

      // Verify initial state
      expect(find.text('0'), findsOneWidget);

      // Tap the increment button
      final fab = find.byKey(const ValueKey('increment_fab'));
      await tester.tap(fab);
      await tester.pumpAndSettle();

      // Verify counter incremented
      expect(find.text('1'), findsOneWidget);
    });
  });
}

Multi-Screen Navigation Flow

dart
testWidgets('login and navigate to home', (tester) async {
  await tester.pumpWidget(const MyApp());

  // Enter credentials
  await tester.enterText(find.byKey(const ValueKey('email_field')), 'user@test.com');
  await tester.enterText(find.byKey(const ValueKey('password_field')), 'password123');

  // Submit login
  await tester.tap(find.byKey(const ValueKey('login_button')));
  await tester.pumpAndSettle();

  // Verify navigation to home
  expect(find.byType(HomePage), findsOneWidget);
  expect(find.byType(LoginPage), findsNothing);
});

按任务相关推荐

flutter
官方

flutter-add-integration-test

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 integrationtest package.

1小时安装量
5
GitHub Stars
3110
最近更新
10月26日
BSD-3-Clause1 文件
查看详情 →

推荐依据: 测试安全
共同关键词: integration · flutter · test

aj-geddes
社区

e2e-testing-automation

Build end-to-end automated tests that simulate real user interactions across the full application stack. Use for E2E test, Selenium, Cypress, Playwright, browser automation, and user journey testing.

1小时安装量
1
GitHub Stars
340
最近更新
3月4日
MIT7 文件
查看详情 →

推荐依据: 测试安全
共同关键词: test · journey · real

leancodepl
社区

patrol-write-test

Write Patrol end-to-end (E2E) tests for a Flutter app — order of actions, Patrol API and assertion rules, native dialog handling, and test-key conventions. Use when adding or editing Patrol/integration tests, assigning widget keys for testing, or debugging a failing Patrol test.

1小时安装量
1
GitHub Stars
1434
最近更新
9月29日
Apache-2.01 文件
查看详情 →

推荐依据: 测试安全
共同关键词: integration · flutter · test

dhruvanbhalara
社区

flutter-add-widget-test

Use when writing widget tests, finding UI elements with finders, simulating user gestures, or testing widget state updates.

1小时安装量
1
GitHub Stars
30
最近更新
8月30日
MIT1 文件
查看详情 →

推荐依据: 测试安全
共同关键词: flutter · test · add

来自同一仓库

更多 Skills

全部 Skills
dhruvanbhalara
社区

dart-logic-patterns

Use when organizing business logic, implementing algorithmic workflows, or applying Dart data structures and pattern matching.

1小时安装量
2
GitHub Stars
30
最近更新
8月30日
MIT1 文件
查看详情 →
dhruvanbhalara
社区

dart-memory

Use when troubleshooting memory leaks, optimizing garbage collection overhead, or disposing streams and listeners in Dart.

1小时安装量
2
GitHub Stars
30
最近更新
8月30日
MIT1 文件
查看详情 →
dhruvanbhalara
社区

dart-optimization

Use when profiling CPU hot paths, optimizing memory allocations, or enforcing static typing performance in Dart.

1小时安装量
2
GitHub Stars
30
最近更新
8月30日
MIT1 文件
查看详情 →
dhruvanbhalara
社区

flutter-code-gen

Use when generating immutable data models, JSON serialization, or dependency injection bindings using buildrunner.

1小时安装量
2
GitHub Stars
30
最近更新
8月30日
MIT1 文件
查看详情 →