跨平台开发 / 系统课时

制定版本号和分支策略

制定版本号和分支策略

版本发布稳定性的基础不是发布脚本,而是一套团队共同遵守的版本号和代码流规则。本篇将帮助团队为 Flutter 项目建立可追踪、可回滚、可协作的版本管理方式。

学习目标

  • 理解语义化版本号在 Flutter 应用发布中的作用。
  • 根据团队规模设计主干、发布分支和标签策略。
  • 掌握版本分支落地时的基本 Git 操作流程。

选择适合项目的版本号规则

Flutter 应用通常需要同时管理应用功能变化、线上修复和商店发布记录。推荐使用语义化版本号,例如 MAJOR.MINOR.PATCH。

版本号各部分含义如下:

部分 适用场景
MAJOR 不兼容的大范围变更,例如重构核心功能
MINOR 新增功能但保持兼容
PATCH Bug 修复、性能优化、小范围调整

例如从 1.4.2 升级到 1.5.0 表示新增功能,从 1.5.0 升级到 1.5.1 表示修复问题。

Flutter 项目中的版本通常还会关联构建号,例如 1.5.1+23,其中 23 用于区分不同构建产物,方便应用商店和内部测试追踪。

设计主干和发布分支

分支策略的核心目标是让开发中的代码和准备发布的代码保持隔离。

小型团队可以采用简单的主干开发模式:

  • main 保存稳定代码。
  • 功能通过短生命周期分支合并。
  • 发布时直接从 main 创建标签。

多人协作或需要多环境发布时,可以增加发布分支:

  • main:线上稳定版本。
  • develop:集成功能代码。
  • feature/*:单个需求开发。
  • release/*:发布准备和测试。
  • hotfix/*:线上紧急修复。

Flutter 项目版本分支策略示意图

发布分支中的主要工作是冻结功能、完成测试和修复发布问题,而不是继续加入新需求。

使用标签记录可发布版本

版本标签用于固定某次代码状态,避免后续提交影响已发布版本。

bash
git checkout main
git pull origin main

git tag -a v1.5.0 -m "Release Flutter app v1.5.0"
git push origin v1.5.0

预期输出

text
To <REMOTE>
 * [new tag]         v1.5.0 -> v1.5.0

标签命名应保持统一,例如始终使用 v1.5.0,不要混用 release-1.5、version15 等形式,否则自动化发布流程难以匹配。

避免版本策略中的常见问题

版本号和分支策略经常出现以下问题:

  • 使用同一个版本号覆盖多个线上包,导致无法定位问题。
  • 发布分支长期存在并持续开发,最后无法确认发布内容。
  • 没有创建标签,只依赖提交时间寻找发布代码。

稳定流程的关键不是分支数量越多越好,而是每个分支都有明确职责。团队规模较小时,应优先选择简单规则,随着发布复杂度增加再逐步扩展。

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

目录与阅读设置

阅读设置

17

记录一个想法

制定版本号和分支策略

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

登录哪都通