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