Git Branch Guide.docx

PageofNUMPAGES8
ProjectName

DocumentNo.

IssueDate
2013-01-21
Revision
V1.0

GitBranchGuideApprovedBy

ReviewedBy

Author

JunqiaoHuangDepartment

DTRWuhanLinux/AndroidTeamRevisionHistory

DateRevisionEditorRemarks2013-01-21V1.0JunqiaoHuangInitversion
RelatedDocuments

DocumentNameRevisionAuthor
目录

TOC\o"1-3"\h\z\uHYPERLINK\l"_Toc346551620"1目的 PAGEREF_Toc346551620\h4
HYPERLINK\l"_Toc346551621"2Master分支 PAGEREF_Toc346551621\h4
HYPERLINK\l"_Toc346551622"3Develop分支 PAGEREF_Toc346551622\h4
HYPERLINK\l"_Toc346551623"4Vendor分支 PAGEREF_Toc346551623\h5
HYPERLINK\l"_Toc346551624"5Feature分支 PAGEREF_Toc346551624\h5
HYPERLINK\l"_Toc346551625"6Release分支 PAGEREF_Toc346551625\h6
HYPERLINK\l"_Toc346551626"7Fixbug分支 PAGEREF_Toc346551626\h7

1目的
本文旨在为基于Git实现SCM（SoftwareConfigurationManagement）而创建branch提供指南。
2Master分支
代码库应该有且仅有一个主分支，即Master分支。所有提供给用户使用的正式版本，都在这个主分支上发布。同时针对master分支上实现的不同功能，需要打上相应的tag。

3Develop分支
Develop分支用来完成日常开发，同时可以用来生成代码的最新隔夜版本（nightly）。
创建Develop分支：
$gitcheckout-bdevelopmaster
4Vendor分支
Vendor分支用于和厂商代码保持同步(如AndroidBSP)，一旦厂商发布新代码，就需要检入到Vendor分支中。当Develop分支开发到一定阶段，就需要合并Vendor分支，以包含厂商最新更新。并非所有的项目都需要用到Vendor分支。
5Feature分支
它是为了开发某种特定功能，为了不影响Develop分支的稳定性，从Develop分支上面checkout出来。开发完成后，需要合并到Develop。

feature分支的名字，采用<name>/feature-*的形式命名,<name>为个人邮箱前缀部分(@之前的名字部分)。
创建一个feature分支：
$gitcheckout-b<name>/feature-xxxdevelop
开发完成后，需要将feature分支合并到develop分支：
$gitcheckoutdevelop
$gitmerge--no-ff<name>/feature-xxx
删除feature分支：
$gitbranch-d<name>/feature-xxx
6Release分支
它是指发布正式版本之前（即合并到Master分支之前），可能需要有一个预发布的版本进行测试。Release(预发布)分支是从Develop分支上面分出来的，预发布结束以后，必须合并进Develop和Master分支。它的命名，可以采用release-<tag-id>的形式。
为版本1.2创建一个预发布分支：
$gitcheckout-brelease-1.2develop
完成测试后，合并到master分支：
$gitcheckoutmaster
$gitmerge--no-ffrelease-1.2
#对合并生成的新节点，打上tag，并注释
$gittag-a1.2-m“”
再合并到develop分支：
$gitcheckoutdevelop
$gitmerge--no-ffrelease-1.2
最后，删除预发布分支：
$gitbranch-drelease-1.2
7Fixbug分支
Fixbug分支用于软件正式发布以后的bug修复。Fixbug分支从Master分支上面checkout出来的。Bug修复结束以后，再合并进Ma