Flutter中基于SemVer规范的CI/CD流水线自动版本控制实现问询

当然可以实现，核心思路是借助Conventional Commits的提交规则自动判定版本升级类型（主版本/次版本/补丁），再结合流水线工具完成Flutter版本号更新、Git打标等操作，不少团队已经落地了这套方案。

核心依赖工具 #

• 用conventional-changelog/standard-version或semantic-release这类工具，它们能解析Conventional Commits提交记录，自动计算符合SemVer的版本号。针对Flutter项目，需要额外配置让工具修改pubspec.yaml（而非默认的package.json）里的版本字段。
• 可以搭配standard-version-updater-pubspec这类专用包，简化pubspec.yaml的版本更新操作。

流水线核心流程（各平台通用） #

1. 环境准备：在流水线中安装Node.js（因为SemVer工具多属于Node生态），然后安装所需的版本控制工具。
2. 版本计算与更新：执行工具命令，自动解析提交记录，更新pubspec.yaml的version字段，部分场景下还需同步更新pubspec.lock或代码中的版本常量。
3. 提交版本变更：将更新后的文件提交回仓库，需确保流水线的Git账号有推送权限。
4. 打Git Tag：工具会自动生成vX.Y.Z格式的SemVer标签，推送到远程仓库。
5. 产物构建适配：打包APK/IPA时，通过--build-name和--build-number参数读取pubspec.yaml中的新版本号，确保产物版本与仓库版本一致。

关键配置示例 #

1. 项目配置文件（.versionrc） #

创建此文件指定工具要更新的目标文件为pubspec.yaml：

{
  "packageFiles": [
    {
      "filename": "pubspec.yaml",
      "updater": "node_modules/standard-version-updater-pubspec/index.js"
    }
  ],
  "bumpFiles": [
    {
      "filename": "pubspec.yaml",
      "updater": "node_modules/standard-version-updater-pubspec/index.js"
    }
  ]
}

2. 流水线步骤示例（以GitHub Actions为例） #

jobs:
  bump-version:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0 # 需拉取全量提交记录用于版本计算

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install dependencies
        run: npm install -g standard-version standard-version-updater-pubspec

      - name: Bump version
        run: standard-version --no-verify
        env:
          GIT_AUTHOR_NAME: github-actions[bot]
          GIT_AUTHOR_EMAIL: github-actions[bot]@users.noreply.github.com
          GIT_COMMITTER_NAME: github-actions[bot]
          GIT_COMMITTER_EMAIL: github-actions[bot]@users.noreply.github.com

      - name: Push changes
        run: git push --follow-tags origin ${{ github.ref }}
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

各平台注意事项 #

• GitLab CI：使用Node镜像配置job，通过CI_JOB_TOKEN或个人访问令牌授予Git推送权限，需在.gitlab-ci.yml中添加类似步骤。
• BitBucket Pipelines：在bitbucket-pipelines.yml中配置Node环境，使用仓库的访问令牌完成代码和标签推送。
• 分支策略：建议仅在主分支（如main）触发版本更新，避免开发分支频繁生成版本。

内容的提问来源于stack exchange，提问作者Sandeep Singh