# 颤振测试仪 ## 概述该技能为为 Flutter 应用程序编写一致、可靠且可维护的测试提供了全面的指导。遵循测试模式、模拟策略和架构指南，以确保测试是隔离的、可重复的，并涵盖成功和错误场景。此技能适用于任何使用 Riverpod、Mockito 和 flutter_test 等常用包的 Flutter 项目。 ## 何时使用此技能在以下情况下使用此技能： * 为存储库、提供者、DAO 或服务创建新的单元测试 * 为 UI 组件和视图编写小部件测试 * 使用 Mockito 和 Riverpod 设置模拟并测试依赖关系 * 实施Given-When-Then测试结构 * 与 Riverpod 提供商一起测试状态管理 * 为多层工作流程编写集成测试 * 调试或修复现有测试 * 确保跨数据、域和表示层的正确测试覆盖 ## 核心测试原则 ### 1\.清洁架构测试在**隔离**中测试每一层： * **数据层** → DAO、API、存储库 * **领域层** → 模型（冻结）、实体 * **表示层** → 提供者 (Riverpod)、视图、控制器 ### 2\.给定何时结构始终使用 Give-When-Then 模式构建测试： test('给定有效数据，当操作执行时，返回预期结果', () async { // 排列（给定） when(mockDAO.getData()).thenAnswer((_) async => testData); // 行动（何时）最终结果=等待repository.fetchData(); // 断言（然后）期望（结果，等于（测试数据））；验证（mockDAO.getData（））。被调用（1）; }); ### 3\.测试组织 * 使用“group()”块对相关测试进行分组 * 使用`setUp()`进行通用初始化 * 使用 `tearDown()` 进行清理（重置 GetIt，释放资源） * 使用`setUpAll()`进行一次性昂贵的设置 ## 测试工作流程 ### 第 1 步：识别被测层确定您正在测试哪个架构层： * **存储库测试** → 模拟 DAO 和 API * **提供商测试** → 模拟服务和存储库 * **小部件测试** → 模拟提供商和服务 * **DAO 测试** → 使用 FakeDatabase ### 第 2 步：设置依赖项和模拟 #### 使用 Mockito 生成模拟 @GenerateMocks([ILogger, ICarouselRepository, INotificationDAO]) 无效主（）{ // 测试代码 } **重要**：切勿直接模拟提供者。相反，重写它们的依赖项。 #### 注册 GetIt 设置（（）{ 模拟记录器 = MockILogger(); 模拟存储库 = MockICarouselRepository(); GetIt.I.registerSingleton(mockLogger); GetIt.I.registerSingleton(mockRepository); }); TearsDown(() => GetIt.I.reset()); #### 共享首选项设置 setUpAll(() 异步 { SharedPreferences.setMockInitialValues({'key1': 'value1'}); SharedPrefManager.instance = 等待 SharedPreferences.getInstance(); }); ### 步骤 3：按照层模式编写测试请参阅“references/layer_testing_patterns.md”文件以获取详细示例： * 存储库测试模式 * 使用 Riverpod 提供测试模式 * 使用 FakeDatabase 测试 DAO 模式 * 带按键和屏幕尺寸设置的小部件测试模式 ### 步骤 4：测试错误场景始终测试成功和失败的路径： test('给定的服务抛出异常，调用时，然后记录错误并返回回退', () async { // 排列最终异常 = Exception('网络错误'); 当(mockService.fetchData()).thenThrow(异常); // 行动最终结果=等待repository.getData(); // 断言期望（结果，为空）； // 或者适当的后备验证（mockLogger.writeExceptionLog（'RepositoryName'，'getData'，异常，任何））。被称为（1）; }); ## 小部件测试要点 ### 始终设置屏幕尺寸 testWidgets('测试描述', (测试人员) async { tester.view.physicalSize = const Size(1000, 1000); tester.view.devicePixelRatio = 1.0; // 你的测试代码 }); ### 始终使用按键查找小部件 **在源代码中：** 升高的按钮( key: const Key('保存按钮'), onPressed: () {}, 孩子：const Text（'保存'），）； **测试中：** 等待 tester.tap(find.byKey(const Key('saveButton'))); 等待 tester.pumpAndSettle(); 如果源小部件中不存在某个键，请在编写测试之前**添加它**。 ### 加载 → 内容转换 when(mockService.fetchData()).thenAnswer((_) async => data); 等待 tester.pumpWidget(createTestWidget()); 期望（find.byType（CircularProgressIndicator），findOneWidget）; 等待 tester.pumpAndSettle(); 期望（find.byType（DataWidget），findOneWidget）； ### 特定于平台的测试 testWidgets('iOS 特定行为', (测试人员) async { debugDefaultTargetPlatformOverride = TargetPlatform.iOS; 等待 tester.pumpWidget(createTestWidget()); 期望（find.byType（CupertinoButton），findsOneWidget）; debugDefaultTargetPlatformOverride = null; }); ## Riverpod 测试 ### 创建具有覆盖的容器最终容器= createContainer（覆盖：[ repoProvider.overrideWith((ref) => mockRepo), ]); 使用 `test/riverpod_container.dart` 中的 `createContainer()` 帮助器，它会在拆卸时自动处理。 ### 测试提供者状态 test('给定有效数据，当状态更新时，则反映新值', () async { 最终通知程序=container.read(provider.notifier); 通知程序.updateState(newValue); Expect(container.read(provider).value!.property, newValue); }); ### 测试初始状态 test('给定空数据，构建初始状态时，然后返回默认状态', () async { when(mockService.fetchData()).thenAnswer((_) async => []); 最终容器= createContainer(); 最终状态=等待container.read(provider.notifier).future; 期望（状态.数据，isEmpty）；期望（状态.isLoading，假）； }); ## 存根模式 ### 成功场景 when(mockRepo.fetchFromDb()).thenAnswer((_) async => mockData); when(mockApi.updateData(any,any,any)).thenAnswer((_) async => true); ### 失败场景 when(mockRepo.fetchFromDb()).thenThrow(Exception('数据库错误')); when(mockApi.updateData(any,any,any)).thenAnswer((_) async => false); ### 使用完成器进行异步控制最终完成者 = Completer(); when(mockRepo.fetchData(any,any)).thenAnswer((_) =>completer.future); 等待 tester.tap(find.text('保存')); 等待 tester.pump(); 期望（find.byType（CircularProgressIndicator），findOneWidget）; Completer.complete(const RegistrationModel(status: '成功')); 等待 tester.pump(); 期望（find.byType（CircularProgressIndicator），findNothing）； ## 假货与假货 ### 何时使用假货使用假实现来实现一致的虚拟行为：类 FakeLogger 扩展 ILogger { @覆盖 void writeInfoLog(String className, String method, String message) {} @覆盖 void writeErrorLog(String className, String method, 动态错误, StackTrace? stack, [String? msg]) {} } 在测试设置中注册： GetIt.I.registerSingleton(FakeLogger.i); ### 何时使用模拟当您需要验证方法调用或设置特定行为时，请使用模拟：当（mockLogger.writeErrorLog（任何，任何，任何，任何））。thenReturn（null）; 验证（mockLogger.writeErrorLog（'ClassName'，'methodName'，异常，任何））。被称为（1）; ## 使用 FakeDatabase 进行数据库测试后期 MenuDAO menuDAO; 后期数据库db；后期 IDatabase 模拟数据库；设置（（）异步{ 等待 FakePathProviderPlatform.initialize(); PathProviderPlatform.instance = FakePathProviderPlatform(); 模拟数据库 = 假数据库(); db = 等待mockDatabase.database；菜单DAO = 菜单DAO( dbManager：模拟数据库，记录器：模拟记录器，）； }); 异步撕裂（）{ 等待 menuDAO.deleteTable(); if (GetIt.I.isRegistered()) { 等待 GetIt.I().close(); } 等待 GetIt.I.reset(); 等待 FakePathProviderPlatform.cleanup(); } ## 测试清单在提交测试之前，请确保： **设置和模拟：** * 依赖项被嘲笑（不是提供者） * SharedPreferences 如果使用则被嘲笑 * GetIt在tearDown中重置 * 流在tearDown中关闭 * 控制器在tearDown中处理 **小部件测试：** * **在小部件测试中添加和使用的键** * 屏幕尺寸设置（physicalSize + devicePixelRatio） * 平台覆盖重置 (debugDefaultTargetPlatformOverride = null) * 导航测试（如果适用） * 对话框/覆盖层已测试（如果显示） **测试覆盖率：** * 涵盖成功和失败的路径 * 测试边缘情况（空、空、最大值） * 负载状态测试 * 已测试错误状态 * 正确处理异步（await、Completer） **代码质量：** * 使用Given-When-Then命名 * 在适当的情况下使用 verify() 或 verifyNever() * 无硬编码延迟（使用 Pump/pumpAndSettle） * 测试是隔离的（测试之间没有依赖关系） * 测试是确定性的（每次结果相同） ## 常见模式 ### 验证模式 // 单次调用验证（mockService.method（））。被调用（1）; // 多次调用验证（mockService.method（））。被调用（3）; // 从未调用过 verifyNever(mockService.method()); // 有序调用验证顺序（[ 模拟服务.method1(), 模拟服务.method2(), ]); ### 测试全局状态导入'package:your_app/path/to/global_variables.dart'作为global_variables；设置（（）{ global_variables.someGlobalVariable = 初始值； }); 拆解（（）{ global_variables.someGlobalVariable = 初始值； // 重置为默认值 }); ### 测试处置/清理 testWidgets('给定提供者已处置，当容器处置时，然后取消订阅并清理', () async { 最终容器= createContainer(); 最终通知程序=container.read(provider.notifier); 等待通知者.future; 容器.dispose(); 验证（mockService.unsubscribe（任何，任何））。被调用（1）; 验证（mockService.dispose（any））。被调用（1）; }); ## 运行测试 ### 运行所有测试颤振测试--覆盖率 # 或者如果使用 FVM： fvm 颤振测试--覆盖率 ### 运行特定的测试文件颤振测试 test/path/to/your_test.dart # 或者如果使用 FVM： fvm 颤振测试 test/path/to/your_test.dart ### 按名称运行特定测试颤振测试--plain-name“给定有效数据” # 或者如果使用 FVM： fvm flutter test --plain-name“给定有效数据” ### 生成覆盖率报告颤振测试--覆盖率 genhtml 覆盖率/lcov.info -o 覆盖率/html # 或者如果使用 FVM： fvm 颤振测试--覆盖率 genhtml 覆盖率/lcov.info -o 覆盖率/html ## 测试助手和实用程序 ### 创建测试小部件包装器 Widget createTestWidget(Widget child) { 返回MaterialApp（主页：脚手架（身体：孩子， ), ）； } // 使用 Riverpod Widget createTestWidgetWithProviders(Widget child, List overrides) { 返回提供者范围（覆盖：覆盖，子项：MaterialApp( 主页：脚手架（身体：孩子， ), ), ）； } ### 可重复使用的 Riverpod 容器助手 ProviderContainer createContainer({List overrides = const []}) { 最终容器= ProviderContainer（覆盖：覆盖）； addTearDown(container.dispose); 返回容器； } ### 按类型和文本查找小部件 // 按类型查找期望（find.byType（CircularProgressIndicator），findOneWidget）; // 通过文本查找期望（find.text（'你好'），findsOneWidget）; // 通过键查找期望（find.byKey（const Key（'myKey'）），findOneWidget）; // 查找后代期望（查找.后代（ of: find.byType(Container), 匹配：find.text('Child'), ), 找到OneWidget，）； // 寻找祖先期望（找到.祖先( of: find.text('Child'), 匹配：find.byType(Container), ), 找到OneWidget，）； ### 匹配器以获得更好的断言 // 常用匹配器期望（值，等于（预期））；期望（值，isNotNull）；期望（值，isNull）；期望（列表，为空）；期望（列表，isNotEmpty）；期望（列表，hasLength（3））；期望（列表，包含（'项目'））；期望（列表，包含All（['a'，'b']））; 期望（值，大于（5））；期望（值，小于（10））；期望（值，在范围（1, 10））； // 自定义匹配器期望（find.byType（Widget），findOneWidget）；期望（find.byType（Widget），findNothing）；期望（find.byType（Widget），findWidgets）；期望（find.byType（Widget），findNWidgets（3））； ## 附加测试模式 ### 使用 GetIt 依赖注入进行测试设置（（）{ GetIt.I.registerSingleton(mockApiService); GetIt.I.registerLazySingleton(() => UserRepository()); }); 拆解（（）{ GetIt.I.reset(); // 在测试之间始终重置 GetIt }); ### 测试基于流的代码 test('给定流发出值，监听时，然后接收所有值', () async { // 排列最终streamController = StreamController(); 最终值 = []; // 行动 StreamController.stream.listen(values.add); 流控制器.add(1); 流控制器.add(2); StreamController.add(3); 等待streamController.close(); // 等待流完成等待 Future.delayed(Duration.zero); // 断言期望（值，等于（[1,2,3]））； }); ### 测试基于计时器的代码 testWidgets('给定计时器完成，倒计时结束时，然后显示消息', (tester) async { 等待 tester.pumpWidget(MyTimerWidget()); // 快进时间等待 tester.pump(const Duration(秒: 5)); Expect(find.text('时间到了！'), findOneWidget); }); ### 测试可滚动小部件 testWidgets('给定长列表，滚动时，然后找到底部项目', (tester) async { 等待 tester.pumpWidget(MyLongListWidget()); // 滚动直到项目可见等待测试者.scrollUntilVisible( find.text('项目 99'), 500.0, ）； Expect(find.text('项目 99'), findOneWidget); }); ## 资源该技能包括带有详细模式和示例的参考文件： ###参考资料/ * `layer_testing_patterns.md` \- 用于测试存储库、提供程序、DAO 和服务的综合示例 * `widget_testing_guide.md` \- 详细的小部件测试模式，包括按键、屏幕尺寸和用户交互 * `riverpod_testing_guide.md` \- 高级 Riverpod 提供程序测试模式和状态管理测试当您需要具体的实现示例或遇到复杂的测试场景时，请参阅这些参考资料。

颤振测试仪

包含技能