跨平台开发 / 系统课时

接入 integration_test

接入 integration_test

Widget 测试适合验证单个界面,完整流程还需要让应用运行在模拟器或真机上,再执行点击、页面更新等真实链路。本节完成 integration_test 的依赖配置、测试入口和设备运行命令,并用一个最小可运行用例确认接入成功。

学习目标

  • 在 Flutter 项目中加入 integration_test SDK 依赖
  • 初始化集成测试绑定并编写可运行的端到端冒烟测试
  • 在模拟器或真机上执行测试并确认测试入口工作正常

加入集成测试依赖

在项目根目录执行:

bash
flutter pub add "dev:integration_test:{sdk: flutter}"

预期输出的关键结果是依赖解析成功,具体新增包数量可能因项目而异:

text
Got dependencies!

执行后,pubspec.yaml 的开发依赖中应包含 integration_test。Flutter 项目通常也会保留 flutter_test:

yaml
dev_dependencies:
  flutter_test:
    sdk: flutter
  integration_test:
    sdk: flutter

配置文件本身不产生控制台结果。可再次执行 flutter pub get 验证依赖能够正常解析;若命令无依赖冲突并完成解析,配置即可生效。

建立集成测试入口

在项目根目录创建 integration_test/app_test.dart。下面示例完全自包含:它初始化 IntegrationTestWidgetsFlutterBinding,启动一个最小应用,点击按钮,再验证计数从 0 变成 1。

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

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  testWidgets('点击按钮后计数加一', (tester) async {
    await tester.pumpWidget(const DemoApp());

    expect(find.text('0'), findsOneWidget);

    await tester.tap(find.byKey(const ValueKey('increment')));
    await tester.pumpAndSettle();

    expect(find.text('1'), findsOneWidget);
  });
}

class DemoApp extends StatefulWidget {
  const DemoApp({super.key});

  @override
  State<DemoApp> createState() => _DemoAppState();
}

class _DemoAppState extends State<DemoApp> {
  int count = 0;

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(
          child: Text('$count', key: const ValueKey('counter-value')),
        ),
        floatingActionButton: FloatingActionButton(
          key: const ValueKey('increment'),
          onPressed: () => setState(() => count++),
          child: const Icon(Icons.add),
        ),
      ),
    );
  }
}

这个文件先用自包含应用验证测试基础设施。接入真实项目时,把 DemoApp 替换为从 lib 中导入的应用根 Widget,就可以继续覆盖登录、搜索、提交表单等完整流程。

在模拟器或真机上运行

先启动目标模拟器或连接真机,再查看 Flutter 能识别到的设备:

bash
flutter devices

预期结果是列表中出现至少一个可运行设备;设备名称和 ID 取决于本机环境:

text
<DEVICE_NAME> • <ID> • <PLATFORM> • <OS_VERSION>

然后把 <ID> 替换为上一步得到的设备 ID:

bash
flutter test integration_test/app_test.dart -d <ID>

预期输出的关键结果如下,构建耗时和测试耗时会因设备而不同:

text
<TIME> +1: All tests passed!

如果项目只连接了一个可用目标,也可以直接运行 flutter test integration_test/app_test.dart。测试会在目标设备上启动应用并执行 WidgetTester 操作。

接入失败时先检查三处

如果测试文件无法编译,先确认 integration_test 位于 dev_dependencies,并重新执行 flutter pub get。如果命令找不到设备,先用 flutter devices 确认模拟器已经启动或真机已完成调试授权。

若测试能启动但一直等待,优先检查 pumpAndSettle() 前后是否存在不会停止的动画、计时器或持续任务。集成测试应该等待“业务流程完成”的明确条件,而不是依赖任意长的固定延时。

完成这一步后,项目就具备了标准的 Flutter 集成测试入口:依赖由 SDK 提供,测试放在 integration_test 目录,运行时由集成测试绑定在目标设备上驱动应用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

接入 integration_test

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通