跨平台开发 / 系统课时
接入 integration_test
接入 integration_test
Widget 测试适合验证单个界面,完整流程还需要让应用运行在模拟器或真机上,再执行点击、页面更新等真实链路。本节完成 integration_test 的依赖配置、测试入口和设备运行命令,并用一个最小可运行用例确认接入成功。
学习目标
- 在 Flutter 项目中加入
integration_testSDK 依赖 - 初始化集成测试绑定并编写可运行的端到端冒烟测试
- 在模拟器或真机上执行测试并确认测试入口工作正常
加入集成测试依赖
在项目根目录执行:
flutter pub add "dev:integration_test:{sdk: flutter}"预期输出的关键结果是依赖解析成功,具体新增包数量可能因项目而异:
Got dependencies!执行后,pubspec.yaml 的开发依赖中应包含 integration_test。Flutter 项目通常也会保留 flutter_test:
dev_dependencies:
flutter_test:
sdk: flutter
integration_test:
sdk: flutter配置文件本身不产生控制台结果。可再次执行 flutter pub get 验证依赖能够正常解析;若命令无依赖冲突并完成解析,配置即可生效。
建立集成测试入口
在项目根目录创建 integration_test/app_test.dart。下面示例完全自包含:它初始化 IntegrationTestWidgetsFlutterBinding,启动一个最小应用,点击按钮,再验证计数从 0 变成 1。
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 能识别到的设备:
flutter devices预期结果是列表中出现至少一个可运行设备;设备名称和 ID 取决于本机环境:
<DEVICE_NAME> • <ID> • <PLATFORM> • <OS_VERSION>然后把 <ID> 替换为上一步得到的设备 ID:
flutter test integration_test/app_test.dart -d <ID>预期输出的关键结果如下,构建耗时和测试耗时会因设备而不同:
<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 目录,运行时由集成测试绑定在目标设备上驱动应用。