版本控制工具使用规范.

版本控制与code review规范

目录

branch使用规则 (3

公共branch命名示例 (3

个人branch命名示例 (3

个人branch创建规则 (3

代码提交流程 (3

Windows平台文件夹方式操作与建议 (4

个人branch创建操作 (4

个人branch代码提交 (6

merge操作 (9

操作步骤1:合并branch (9

操作步骤2:解决冲突 (12

Eclipse 插件方式操作与建议 (14

Mac平台操作与建议 (21

1.采用CornerStone客户端进行SVN操作 (21 1、与服务器创建连接 (21

2、个人branch创建操作 (22

3、把服务器上个人branch 进行check out 到本地 (24

4、个人branch提交(commit操作 (25

5、merge操作 (26

2.采用终端命令提示符进行SVN操作 (28

1、将文件checkout到本地目录 (28

2、往版本库中添加新的文件 (29

3、将改动的文件提交到版本库 (29

4、加锁/解锁 (29

5、更新到某个版本 (29

6、查看文件或者目录状态 (30

7、删除文件 (31

8、查看日志 (32

9、查看文件详细信息 (32

10、比较差异 (32

11、将两个版本之间的差异合并到当前文件 (34

12、SVN 帮助 (35

13、版本库下的文件和目录列表 (35

14、创建纳入版本控制下的新目录 (36

15、恢复本地修改 (36

16、代码库URL变更 (36

17、解决冲突 (37

18、输出指定文件或URL的内容。 (37

branch使用规则

公共branch命名示例

branch-20150326-candidate

个人branch命名示例

branch-20150326-hulanlan

branch-20150326-taskID

个人branch创建规则

●开发人员基于每个开发小任务创建自己的branch, 以每天check in 自己的代码作备份。

●基本原则是从最新代码创建branch,以方便未来的代码合并

●原则是不直接在服务器上操作

代码提交流程

1.测试本地代码

2.整理本地代码, 申请code review

3.提交本地代码到个人branch

4.给目标branch加锁

get lock (目标branch

5.merge个人branch到目标branch

6.测试merge后的目标branch代码

7.提交merge后代码到目标branch

8.给目标branch解锁

Windows平台文件夹方式操作与建议个人branch创建操作

前提:收到任务及编号

操作步骤:

1, 在本地最新代码branch所在目录上点击"TortoisSVN -> Branch/tag" , 如图:

2, 在弹出的窗口中输入相应信息:

注意:

●检查From URL 对应在值为最新目标branch 地址●TO Path 输入您的新branch 名称

3, 点击OK后将发现新branch已经在服务器上创建成功, 现在就可以checkout 到本地干活了。

checkout代码到本地

个人branch代码提交

1、检查新增代码文件新增、删除是否正确操作

描述:打开项目所在的文件夹,右击TortoiseSVN——Check for modfications,弹出如下图窗口。

新增代码文件未加入版本控制时有non-revisioned提示, 如图:

没有通过svn操作而直接进行删除会有missing file 提示,如图:

2、将未加入版本控制的文件加入版本控制

描述:对于non-versioned的文件(除自动生成的文件外,找到其所在的位置,执行add 操作。

加入版本控制操作

正确的svn删除操作:

3、提交代码到自己的branch

描述:打开项目所在的文件夹,右击SVN Commit,弹出如下图窗口,输入本次提交的功能描述后,点击Ok就将代码提交到自己的branch中。

注意:

●这里是提交代码到个人branch, 所以code review 不是必须的。

●不要提交生成文件

代码提交前可以双击文件查看变更,如图:

merge操作

示例任务:

把最新branch的代码

(http://192.168.0.165/svn/amoby-android/branches/branch-20150325-hulanlan

合并到个人branch

(http://192.168.0.165/svn/amoby-android/branches/branch-20150330-taskid_zhou 任务的假设

本地项目文件夹为myproject 且本地文件均已经submit到个人branch中

注意:

如果是merge代码到公共branch, 需要对目标branch执行lock操作,代码提交成功后执行release lock操作

此处定义在merge操作并不是代码提交前应做的完整merge流程.

操作步骤1:合并branch

右击本地项目文件夹myproject,选择SVN checkout——Merge:

选择Merge操作后弹出如下图窗口,这里可以选择默认merge type,然后点击Next