Git工作流及发布规范(App)

App开发Git工作流及发布规范

Nov 8, 2017

参考

介绍

本约束规则适用于所有iOS和Android工程代码。管理工具使用Coding.net提供的git托管服务。

Git的workflow有多种,各有利弊,无所谓好坏。但团队协作需要有一致的规范,所以请大家务必遵守。

除了一致性之外,这个规范的目的是以下几点:

  • 方便开发和测试同学协同,高效完成研发工作,产出高质量的成果。
  • 在需要修复紧急 bug 并尽快发布时,可以只发布必要的 bugfix 而不同时发布还不应发布的其他改动。

branch和tag

使用Feature Branch Workflow,按照需求新建feature branch

Branch: feature branchmasterrelease。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;

发布新版本详细步骤

  1. Coding上删除release分支;
  2. Coding上从master分支新建release分支;
  3. 从release分支打包供集成测试后发布;
  4. 在Coding上基于release分支打tag,添加更新日志。

发布补丁详细步骤

  1. 先update整个工程;
  2. git切换到release分支;
  3. 执行 git cherry-pick commit_id 命令;
  4. push到远程release分支;
  5. 从release分支打包供集成测试后发布。
  6. 在Coding上基于release分支打tag,添加更新日志。

其他

  • 并不是每个 bug 都有专门发布 bugfix 版的必要,对于不紧急的 bug,可以 fix 后随下一个版本发布。
  • master分支和release分支只有负责人有readwrite权限,其他开发人员只有read权限。