参考
- http://open.leancloud.cn/git-branch-guide.html
- https://blog.coding.net/blog/feature-branch-workflow
- https://blog.coding.net/blog/git-workflow
- https://blog.coding.net/blog/principle-of-Git
介绍
本约束规则适用于所有iOS和Android工程代码。管理工具使用Coding.net提供的git托管服务。
Git的workflow有多种,各有利弊,无所谓好坏。但团队协作需要有一致的规范,所以请大家务必遵守。
除了一致性之外,这个规范的目的是以下几点:
- 方便开发和测试同学协同,高效完成研发工作,产出高质量的成果。
- 在需要修复紧急 bug 并尽快发布时,可以只发布必要的 bugfix 而不同时发布还不应发布的其他改动。
branch和tag
使用Feature Branch Workflow,按照需求新建feature branch
Branch: feature branch、master 和 release。master是默认分支,release 是用于发布的分支。
- feature branch: 功能开发或bug修复从master新建一个分支,push到远程仓库,提交合并至master的请求,合并后删除该分支。
- master: 只负责合并各feature branch的代码,且保证master分支随时处于可测试,测试之后可发布状态。 提交后自动触发集成。
- release: 是当前发布的分支,在这个分支只能从master新建 或 增加从 master cherrypick 过来的 commit。
Tag: 对应每个发布版本的 tag。
- SDK 和App应用程序的 tag 遵照
<major>.<minor>.<patch>
的命名,如 2.5.1,参考SemVer; - 服务端程序的 tag 以发布的日期命名,如 2016.07.28,如果有 bugfix,则在后面增加小写字母,如 2016.07.28 后是 2016.07.28a,然后是 2016.07.28b。
图片
branch&tag
代码提交应尽量采用原子性的提交,即基于单一功能的提交(worktile单一任务或其拆分出的功能),不建议一次性提交多个功能,必须保证每次提交都是可执行的完整功能。提交时必须写清晰的提交日志。
开发测试流程
-
开发测试流程
图片
发布管理
所有版本发布前,测试工程师必须确认测试已完全覆盖并通过。
- 发布新版流程:删除旧的 release branch,并从当前的 master 创建新的 release branch;
- Bugfix 流程: bugfix 指的是修复已经发布的程序(release branch)中的缺陷。在 release branch 从 master branch cherry pick 修复该缺陷的一个或多个 commit;
发布新版本详细步骤
- Coding上删除release分支;
- Coding上从master分支新建release分支;
- 从release分支打包供集成测试后发布;
- 在Coding上基于release分支打tag,添加更新日志。
发布补丁详细步骤
- 先update整个工程;
- git切换到release分支;
- 执行 git cherry-pick commit_id 命令;
- push到远程release分支;
- 从release分支打包供集成测试后发布。
- 在Coding上基于release分支打tag,添加更新日志。
其他
- 并不是每个 bug 都有专门发布 bugfix 版的必要,对于不紧急的 bug,可以 fix 后随下一个版本发布。
- master分支和release分支只有负责人有readwrite权限,其他开发人员只有read权限。
网友评论