Bear 實驗室: 什麼是Git flow ? 如何在SourceTree使用Git flow管理開發!

http://www.takobear.tw/12/post/2014/02/bear-git-flow-sourcetreegit-flow.html

Bear 實驗室: 什麼是Git flow ? 如何在SourceTree使用Git flow管理開發!

02/14/2014

今天Bear實驗室的主題不是要介紹程式，而是來好好介紹一下有關管理進度開發的工具!
那今天實驗室的主題是.....Git Flow!!!!
使用 git 的開發者都知道 git 有 branch 這個功能，但要如何運用在開發流程呢？
(以下內容將以Source Tree講解，不知道Source Tree是什麼的請點此連結)

什麼是 git flow?

有關Git flow呢，現在網路上有人整理出了一套模型流程：A successful Git branching model
附上簡體翻譯版：一个成功的Git分支模型

一個Git flow，其中的內容大致可以區分如下：

主要分支
* master：釋出的版本，只從 release 與 hotfix merge 回來，不直接在上面 commit 變更。
* develop：開發中的版本，預設在這 branch 上，開發修改功能都從這分支出去。

支援性分支
* feature branches：從 develop 分支出來，當功能開發修改完成後 merge 回 develop
* release branches：從 develop 分支出來，是準備釋出的版本，只修改版本號與 bug，完成後 merge 回 develop 與 master，並在 master 標上版本號的 tag
* hotfix branches：從 master 分支出來，主要是處理已釋出版本需要立即修改的錯誤，完成後 merge 回 develop 與 master，並在 master 標上版本號的 tag

在本篇教學中，採用 SourceTree 這套 git gui 工具，因為它有整合了git flow的功能，很方便。
如果你超愛指令，但又不想打太多，你可以參考Git-flow 使用笔记安裝git-flow工具操作。

本篇教學範例將以圖說的方式，列出以下步驟，並在部分步驟中列出相對應的指令以供參考：
* 初始化專案的 git flow 設定
* 開發新功能(feature)
* 釋出專案(release)
* 緊急上版(hotfix)

以下教學需要使用到SourceTree，關於SourceTree官方網站請點以下連結
SourceTree下載連結 (Mac, Windows皆適用)

初始化專案的 git flow 設定

執行 SourceTree 點擊 Add Repository。

因為我們是建立一個新的空目錄，所以切換到 Create Repository頁面，輸入資訊後點擊 Create。

雙擊剛剛建立的 Repository。

因為整個專案都是空的，所以我們需要 commit 一次，以建立 master branch。

先在專案目錄下新增一個文字檔。

在 Working Copy頁面中，選取剛剛放進專案目錄中的文字檔，點擊 Add。

檔案就會從下方移到上方，準備 commit。接著點擊 Commit。

輸入 Commit message 後，點擊 Commit。

Commit 之後就可以看到 BRANCHES 下多出了 master。接下來就可以點擊 Git Flow 為專案初始化 git flow設定。

基本上不用再調什麼設定，直接點擊 OK。

參考指令:

1	git checkout -b develop master

view raw create_branch_develop.sh hosted with ❤ by GitHub

完成後就會看到在 BRANCHES 下出現 develop 了，這樣就完成了 git flow 的初始化。

開發新功能(feature)

點擊 Git flow 開啟選單。

點擊 Start a New Feature。

輸入Feature Name，然後點擊 OK，建立新的 branch 用來開發新功能。

參考指令：

1	git checkout -b feature/f1 develop

view raw start_feature.sh hosted with ❤ by GitHub

在 BRANCHES 下可以看到新增了 feature/f1 這個 branch，我們在這 branch 上開發新功能。

在專案目錄下新增一檔案，用來代表新功能，接下來就是老樣子的 commmit 動作。

這邊我們隨意建了一個新檔案叫做main.c!

在 Working Copy頁面中，選取剛剛放進專案目錄中的檔案，點擊 Add。

檔案就會從下方移到上方，準備 commit。接著點擊 Commit。

輸入 Commit message 後，點擊 Commit。

回到 BRANCHES，因為新功能完成了，所以我們要將 feature/f1 merge 回 develop。點擊 Git Flow 叫出選單。

因為目前我們在 feature/f1 上，所以點擊 Finish Current就可以了。

這邊直接點擊 OK。

參考指令：

123	git checkout develop git merge --no-ff feature/f1 git branch -d feature/f1

view raw finish_feature.sh hosted with ❤ by GitHub

回到只有 develop 與 master 兩個 branch 的狀態了。重複以上動作直到功能開發完成，就要進行下一個步驟，釋出專案給使用者。

釋出專案(release)

當功能都開發完成之後，就可以進行準備釋出專案，在這 release branch 上做的動作主要就是修改版本號之類的釋出設定。
釋出專案的話，就代表你開發完成了要出去給測試或是準備上架囉!!

點擊 Git Flow。

點擊 Start a New Release。

輸入版本號，點擊 OK(預設是從 develop 最新的版本分支)。

參考指令：

1	git checkout -b release/v0.1.0 develop

view raw start_release.sh hosted with ❤ by GitHub

在 BRANCHES 下可以看到出現了 release/v0.1.0 的 branch。

現在讓我們修改一下專案目錄下的 README.md 的內容，加上版本號資訊後存檔。

(畫面中使用的是 Mou Markdown 編輯器, 在Mac上編輯README相當好用, 有機會Bear再詳加介紹)

接下來 commit 剛剛的變更，一樣切換到 Working Copy 頁面，選取變更的檔案，點擊 Add。

點擊 Commit。

輸入 Commit message 後點擊 Commit。

回到 BRANCHES 頁面，可以看到 Graph 有變動了。接下來請點擊 Git Flow。

因為目前我們正在 release/v0.1.0 branch，所以直接點擊 Finish Current。

點擊 OK。請注意在 Git Flow 流程中，release branch 只負責釋出設定與修正 bug，千萬不要在上面開發新功能。

參考指令：

123456789

git checkout master

git merge --no-ff release/v0.1.0

git tag -a v0.1.0

git checkout develop

git merge --no-ff release/v0.1.0

git branch -d release/v0.1.0

view raw finish_release.sh hosted with ❤ by GitHub

Graph 就會出現了變更，release/v0.1.0 會 merge 到 master 跟 develop。並在 master 上標上 v0.1.0 的 tag。

經由以上步驟，我們就學會了依照 Git Flow 從開發到釋出的流程。

緊急上版(hotfix)

當專案釋出之後，可能才發現有重大的錯誤，
但一時之間新功能也正在開發，無法及時釋出新版本.....
這時候可以從 master 分支出 hotfix branch 做緊急上版。

假設目前專案正在進行新功能的開發，如上圖所示，但突然發現版本v0.1.0有錯誤需要馬上修改。請點擊 Git Flow。

因為目前我們在正 feature/f2 branch上，所以我們點擊 Other Action…開啟選單。

點擊 Start Hotfix。

輸入版本號，因為目前我們要修正的版本是v0.1.0，所以按照慣例這裡輸入v0.1.1。點擊 OK。

參考指令：

1	git checkout -b hotfix/v0.1.1 master

view raw start_hotfix.sh hosted with ❤ by GitHub

可以看到 Graph 發生了變動，hotfix/v0.1.1是從 master 分支出來的，接下來就可以修正錯誤，這邊就不再重複講述 commmit 的步驟。

錯誤已經修復好也 commit 了，接下來就是釋出更新的版本。請點擊 Git Flow。

因為目前我們就在 hotfix/v0.1.1上，所以直接點擊 Finish Current。

點擊 OK。

參考指令：

123456789

git checkout master

git merge --no-ff hotfix/v0.1.1

git tag -a v0.1.1

git checkout develop

git merge --no-ff -b hotfix/v0.1.1

git branch -d hotfix/v0.1.1

view raw finish_hotfix.sh hosted with ❤ by GitHub

可以在 Graph 中看到了變更，hotfix/v0.1.1 會 merge 到 master 跟 develop。並在 master 上標上 v0.1.1 的 tag。之後再切換到 feature/f2 繼續開發新功能。

以上就是在 SourceTree 使用 Git flow 開發流程的方式。

最後如果希望下載SourceTree的，請點此處下載

想了解SourceTree是什麼的，請參考Takobear: SourceTree簡介一文

參考網站：
A successful Git branching model
Git flow 開發流程
 Git-flow 使用笔记
 Git 版本控制 branch model 分支模組基本介紹