TortoiseGit项目管理指南

1         软件的安装与配置

TortoiseGit是Windows下不错的一款Git客户端工具，下面就介绍一下TortoiseGit安装和使用的方法。

安装TortoiseGit并使用它须要两个软件：TortoiseGit和msysgit。

1.1       下载软件

TortoiseGit官网下载地址：http://code.google.com/p/tortoisegit/

git-for-windows官网下载地址：https://git-for-windows.github.io/

下载的版本分别是：TortoiseGit-2.4.0.2-64bit.msi和 Git-2.12.0-64-bit.exe。

1.2       安装软件

这个其实真没什么说的，先安装Git-2.12.0-64-bit.exe, 再安装TortoiseGit-2.4.0.2-64bit.msi.而后就没问题了。

1.3       检查TortoiseGit安装的正确性

先在TortoiseGit安装目录里面找到Settings，打开界面，找到General，点击“Check now”按钮，能够看到当前git版本。这时候说明，你的配置已经OK，能够开始进行下一步的操做了。

 

 

1.4       建立版本库

在项目文件夹用鼠标右键点击，能够看到Git和TortoiseGit已经嵌入右键了，选择“Git Create repository here”，而后点击“OK”按钮，再点击“Proceed”，这样就会在项目文件中建立了一个“.git”的隐藏目录（有时候可能出现建立失败须要重启电脑）。

                                                                                                                     

 1.5       配置Tortoise

任意文件夹下空白处，鼠标右击，选择“TortoiseGit”->“Settings”， 在“User Info”输入Name和Email。点击“Remote”，在Remote输入名称，URL输入Git的HTTPS或者SSH地址。点击“Add New/Save”按钮添加一个项目。

 

 

                                                                                                                                

 

上图中的url能够是你的Github中版本库的地址，也能够是本地地址（如:E:\GitShare, 而后将该文件夹与网盘同步，注意，此时选择“Git Create repository here”时须要勾选上”Make it Bare”）。咱们这里版本库托管在coding.net（优点在于能够免费建立私有库，且访问速度快）上面，url为：…………..。

至此下载和安装配置TortoiseGit就完成了，后面就是团队协做的详细介绍

2         团队协做开发

参考自：

http://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000

2.1       基本认识

图 1 Git 分支管理原则

一个基础的概念是：git有不一样的分支，上面的内容能够不同。在实际开发中，master分支应该是很是稳定的，也就是仅用来发布新版本，平时不能在上面干活；那在哪干活呢？干活都在dev(developer)分支上，也就是说，dev分支是不稳定的，到某个时候，好比1.0版本发布时，再把dev分支合并到master上，在master分支发布1.0版本。

团队每一个人都在dev分支上干活，每一个人都有本身的分支，时不时地往dev分支上合并就能够了（最好在代码等没有bug时再往上push，由于团队每一个人都会pull一样dev分支的内容，有bug容易影响他人工做的进度）。

2.2       开始工做

2.2.1         Clone远程版本库

新建一个放置项目的文件夹，在文件夹内空白处右击鼠标选择Git Clone,在图示红框内输入须要克隆的远程库URL地址，不报错即同步到了远程库的内容，以下图。                                                          

                                                                                                                               

2.2.2         添加并转换到dev分支上进行开发

若是远程库上没有其余的分支，那么clone获得的库是master分支下的内容。对团队中的单个开发者而言，咱们须要添加dev（developer）（团队一致，不要改成其余的名）分支。

(1)     鼠标右击TortoiseGitàCreater BranchàOK即完成了分支的建立。

 

(2)     鼠标右击TortoiseGit-->Switch/Checkout-->Branch-->dev-->OK即转换到了dev分支上。

2.2.3         Add, Commit, Push

(1)   此时咱们开始开发，好比说建立了newDocBydev.docx,咱们看到该文件上有一个问号，提示你该文件暂处于工做区，没有Add到版本库（.git文件夹）,而后咱们鼠标右击TortoiseGit-->Add-->OK

(2)   此时更改文件被提交到了暂存区，文件夹上显示加号。而后你能够鼠标右击Git Commit, 并记得在message栏对你的更改作简要介绍，勾选日期和做者栏，而后在Check栏选择你要Commit的文件。而后点击Commit。提交完后文件上有一个绿色的勾，表示提交成功。Add和Commit操做的基本工做逻辑如图 3所示。

                                                                                            

                   图 2 Add以后的状态                                                                                                                                                                                                                图 3 Git的基本工做逻辑

(3)   此时你的文件已经提交到了代码库，待没有明显bug问题后，你能够将它push（同步你的内容到远程）到远程库，这样你们也就能同步到你的进度了。鼠标右击àTortiseGit-->Push-->OK,有时候，团队其余成员Push了新的内容以后而你尚未同步时会报错，此时即根据提示先Pull（同步远程的内容到本地）一下，再Push便可。

 

(4)   此时咱们看到远程库下多了一个dev分支，刚才提交的内容也同步上来了。

 

2.2.4        合并分支

待一段时间后，Merge稳定的dev分支到master上。

(1)     鼠标右击TortoiseGit-->Switch/Checkout-->Branch-->master-->OK,此时将工做分支切换到了master分支上。回到文件目录，咱们看到是没有newDocBydev文件的。

                                                                                                                         

 

(2)     鼠标右击-->TortoiseGit-->Merge-->Branch-->dev—OK,此时即实现了将dev分支Merge到master分支上去。如图 4所示，咱们看到dev分支开发的文件以及合并到了master分支，最后再Push到远程库便可完成同步。待开始新的开发，咱们须要再将分支转换到dev上去。

                                                                                                                         

                                                                                                                                                                                                                                                图 4 Merge以后的master目录

3         附录：

3.1       帐户SSH公钥

(详情参考https://coding.net/help/doc/git/ssh-key.html#ssh-)

3.1.1        获取 SSH 协议地址

在项目的代码页面点击 SSH 切换到 SSH 协议， 得到 clone 地址，形如https://git.coding.net/Xiaolin_Yuan/gitTest.git。请使用这个地址来访问您的代码仓库。

3.1.2        生成公钥

Windows打开Git Bash，输入ssh-keygen -t rsa -C “username@example.com”,( 注册的邮箱)，接下来点击enter键便可（也能够输入密码）。

3.1.3        在 Coding.net 添加公钥

(1)     本地打开 id_rsa.pub 文件（或执行 $cat id_rsa.pub ），复制其中所有内容，添加到帐户“SSH 公钥”页面中，公钥名称能够随意起名字。

(2)     完成后点击“添加”，而后输入密码或动态码便可添加完成。

3.2       另对Git有什么疑问能够参考：

http://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000