跨平台开发 / 系统课时
制定版本号和分支策略
制定版本号和分支策略
版本发布稳定性的基础不是发布脚本,而是一套团队共同遵守的版本号和代码流规则。本篇将帮助团队为 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/*:线上紧急修复。

发布分支中的主要工作是冻结功能、完成测试和修复发布问题,而不是继续加入新需求。
使用标签记录可发布版本
版本标签用于固定某次代码状态,避免后续提交影响已发布版本。
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 等形式,否则自动化发布流程难以匹配。
避免版本策略中的常见问题
版本号和分支策略经常出现以下问题:
- 使用同一个版本号覆盖多个线上包,导致无法定位问题。
- 发布分支长期存在并持续开发,最后无法确认发布内容。
- 没有创建标签,只依赖提交时间寻找发布代码。
稳定流程的关键不是分支数量越多越好,而是每个分支都有明确职责。团队规模较小时,应优先选择简单规则,随着发布复杂度增加再逐步扩展。
按自己的节奏,确认真正理解。