跨平台开发 / 系统课时
设计 Flutter CI 基础流水线
设计 Flutter CI 基础流水线
本篇解决 Flutter 项目如何从零建立持续集成流水线的问题,通过拆分代码获取、环境准备、依赖安装和质量检查阶段,让每次提交都能自动验证项目状态。
学习目标
- 理解 Flutter CI 流水线的核心阶段和执行顺序
- 掌握在自动化环境中准备 Flutter 项目的基本配置
- 能够设计适合团队协作的基础检查流程
CI 流水线的基本结构
Flutter CI 的目标不是替代开发环境,而是在代码进入主分支前提供稳定、重复的验证环境。一条基础流水线通常包含 checkout、Flutter 环境准备、依赖解析、代码检查和测试几个阶段。
这些阶段之间存在明确依赖关系:只有代码和 Flutter SDK 准备完成后,依赖安装、分析和测试才有意义。

创建基础 GitHub Actions 流程
下面示例使用 GitHub Actions 描述一个最小 Flutter CI 流程。实际项目中需要根据仓库结构调整触发分支和 Flutter 版本。
yaml
name: flutter-ci
on:
pull_request:
branches:
- main
jobs:
flutter-check:
runs-on: ubuntu-latest
steps:
- name: Checkout source
uses: actions/checkout@v4
- name: Setup Flutter
uses: subosito/flutter-action@v2
with:
flutter-version: 'stable'
- name: Install dependencies
run: flutter pub get
- name: Analyze code
run: flutter analyze预期结果
text
Run flutter pub get
Dependencies resolved.
Run flutter analyze
No issues found!这个流水线只验证代码分析是否通过,还没有执行测试。这样拆分可以让团队先建立稳定反馈,再逐步增加测试、构建和发布阶段。
设计阶段时需要关注的问题
CI 流程设计的重点不是步骤越多越好,而是保证每个阶段都能快速发现问题。
常见设计原则包括:
- 将环境准备固定化,避免不同开发机产生差异
- 将依赖安装作为独立阶段,方便定位依赖问题
- 将静态检查和测试作为合并前门槛
- 保持流水线执行时间可接受,避免开发者绕过检查
对于大型 Flutter 项目,还可以进一步加入缓存、分平台构建和产物上传,但基础流水线应先保证可重复执行。
验证流水线是否有效
提交一次包含 Dart 文件修改的 Pull Request,观察 CI 是否能够完成环境准备、依赖安装和检查任务。如果修改产生静态分析错误,流水线应该明确失败并阻止合并。
一个设计良好的基础 CI 流程,应让团队在代码进入共享分支前发现格式、类型和依赖问题,而不是等到人工测试阶段才暴露。
按自己的节奏,确认真正理解。