AgileBuilder logoAgileBuilder
返回文档

模板分支管理

管理模板的不同版本和分支

概述

AgileBuilder 支持通过 Git 分支管理模板的不同版本，让你可以维护多个版本的模板，支持并行开发和版本回滚。

为什么需要分支管理

  • 版本迭代：为模板的不同版本维护独立分支
  • 实验性功能：在新分支上实验，不影响稳定版本
  • 团队协作：多人同时开发不同功能
  • 发布管理：从特定分支发布稳定版本

分支命名规范

建议使用以下命名规范：

分支类型命名格式示例
主版本mainmain
开发版developdevelop
功能分支feature/*feature/add-typescript
修复分支fix/*fix/correct-dependencies
发布分支release/*release/v1.0.0

分支操作

添加特定分支的模板

agilebuilder template add https://github.com/your-org/your-template.git --branch develop

切换模板分支

agilebuilder template update my-template --branch feature/new-feature

查看模板分支

agilebuilder template info my-template --show-branches

多版本管理

版本标签

在 Git 中使用标签标记版本：

git tag v1.0.0
git push origin v1.0.0

使用特定版本

agilebuilder template add https://github.com/your-org/your-template.git#v1.0.0

工作流程

开发新功能

# 1. 从 main 创建功能分支
git checkout -b feature/new-feature

# 2. 开发并提交
git commit -m "feat: 添加新功能"

# 3. 推送分支
git push origin feature/new-feature

# 4. 测试功能分支的模板
agilebuilder template add https://github.com/your-org/your-template.git --branch feature/new-feature

发布稳定版本

# 1. 合并到 main
git checkout main
git merge feature/new-feature

# 2. 创建发布标签
git tag v1.0.0

# 3. 推送
git push origin main --tags

分支策略示例

main (稳定版本)
├── v1.0.0 ─────────────────────────
│
develop (开发版本)
├── feature/typescript ──────────────
├── feature/new-ui ──────────────────
└── fix/bug ─────────────────────────

最佳实践

  1. main 分支保持稳定 - 始终可以用于生成项目
  2. 使用语义化版本 - v1.0.0, v1.1.0, v2.0.0
  3. 定期合并 - 将功能分支合并回 develop
  4. 文档更新 - 每次发布更新文档

下一步