跨平台开发 / 系统课时
在 CI 中执行 analyze 和 test
在 CI 中执行 analyze 和 test
本篇解决 Flutter 项目如何把静态分析和自动测试接入 CI 的问题,让代码质量检查从开发者习惯变成合并代码前的自动化规则。
学习目标
- 理解 flutter analyze 和 flutter test 在 CI 中的职责
- 掌握将质量检查命令加入自动化流程的方法
- 能够根据失败结果定位代码质量问题
analyze 和 test 在 CI 中的职责
Flutter CI 中的质量检查通常分为两个层次。
flutter analyze 负责发现代码层面的潜在问题,例如类型错误、未使用代码、不符合分析规则的问题。它不执行程序逻辑,因此速度通常较快。
flutter test 负责验证代码行为,通过运行测试用例确认业务逻辑是否符合预期。
两者结合后,CI 可以同时覆盖代码规范和功能正确性。
配置 analyze 和 test 阶段
在基础流水线准备完成后,可以增加两个执行步骤。下面示例假设项目已经完成 flutter pub get。
yaml
steps:
- name: Install dependencies
run: flutter pub get
- name: Static analysis
run: flutter analyze
- name: Run tests
run: flutter test预期结果
text
Run flutter analyze
No issues found!
Run flutter test
00:02 +3: All tests passed!如果分析失败或测试失败,CI 任务会返回失败状态,代码合并流程可以根据仓库规则阻止继续执行。
如何处理 CI 失败
不同失败类型对应不同排查方向。
| 失败阶段 | 常见原因 | 优先检查 |
|---|---|---|
| analyze | 类型错误、Lint 规则失败 | Dart 文件和 analysis_options.yaml |
| test | 测试断言失败、环境差异 | 测试代码和依赖版本 |
| pub get | 依赖冲突 | pubspec.yaml 和锁定版本 |
CI 失败时不要直接重跑任务。重复执行只能确认问题是否偶发,不能替代定位根因。
让测试成为合并门槛
团队通常会把 analyze 和 test 放入 Pull Request 检查中。这样每个提交都会经过相同规则验证,减少“本地能运行,合并后失败”的情况。
对于测试数量较多的项目,可以进一步区分快速单元测试和耗时较长的集成测试,让开发反馈速度和覆盖范围保持平衡。
验证质量门槛是否生效
可以故意制造一个分析错误或修改测试断言,提交代码后观察 CI 是否失败。
一个有效的质量门槛应该满足两个条件:问题代码能够被自动发现,修复后的代码能够稳定通过同一套检查流程。
按自己的节奏,确认真正理解。