跨平台开发 / 系统课时

设计 Flutter CI 基础流水线

设计 Flutter CI 基础流水线

本篇解决 Flutter 项目如何从零建立持续集成流水线的问题,通过拆分代码获取、环境准备、依赖安装和质量检查阶段,让每次提交都能自动验证项目状态。

学习目标

  • 理解 Flutter CI 流水线的核心阶段和执行顺序
  • 掌握在自动化环境中准备 Flutter 项目的基本配置
  • 能够设计适合团队协作的基础检查流程

CI 流水线的基本结构

Flutter CI 的目标不是替代开发环境,而是在代码进入主分支前提供稳定、重复的验证环境。一条基础流水线通常包含 checkout、Flutter 环境准备、依赖解析、代码检查和测试几个阶段。

这些阶段之间存在明确依赖关系:只有代码和 Flutter SDK 准备完成后,依赖安装、分析和测试才有意义。

Flutter CI 基础流水线阶段关系图

创建基础 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 流程,应让团队在代码进入共享分支前发现格式、类型和依赖问题,而不是等到人工测试阶段才暴露。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计 Flutter CI 基础流水线

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

登录哪都通