Git和Repo掃盲——如何取得Android原始碼

轉自http://www.williamhua.com/2009/04/29/git-and-repo-for-dummies/

Git 是 Linux Torvalds 為了協助管理 Linux
核心開發而開發的一個開放源碼的分布式版本控制軟體，它不同於Subversion、CVS這樣的集中式版本控制系統。在集中式版本控制系統中只有一個倉庫（repository），許多個工作目錄（working
copy），而像Git這樣的分布式版本控制系統中（其他主要的分布式版本控制系統還有BitKeeper、Mercurial、GNU Arch、Bazaar、Darcs、SVK、Monotone等），每一個工作目錄都包含一個完整倉庫，它們可以支援離線工作，本地提交可以稍後提交到伺服器上。分布式系統理論上也比集中式的單伺服器系統更健壯，單伺服器系統一旦伺服器出現問題整個系統就不能運行了，分布式系統通常不會因為一兩個節點而受到影響

因為Android是由kernel、Dalvik、Bionic、prebuilt、build等多個Git項目組成，所以Android項目編寫了一個名為Repo的Python的指令碼來統一管理這些項目的倉庫，使得Git的使用更加簡單。

這幾天William為了拿Android最新的sourcecode，學習了一下git和repo的一些基本操作，整理了一個如何取得Android代碼的How-To，今天把他貼上來。

1、Git的安裝
在Ubuntu
8.04上安裝git只要設定了正確的更新源，然後使用apt-get就可以了，有什麼依賴問題，就讓它自己解決吧。其中cURL是一個利用URL文法在命令列下工作的檔案傳輸工具，會在後面安裝Repo的時候用到。
sudo
apt-get install git-core curl

2、安裝Repo
首先確保在目前使用者的主目錄下建立一個/bin目錄（如果沒有的話），然後把它(~/bin)加到PATH環境變數中
接下來通過cURL來下載Repo指令碼，儲存到~/bin/repo檔案中
curl
http://android.git.kernel.org/repo >~/bin/repo

別忘了給repo可執行許可權
chmod a+x ~/bin/repo

3、初始化版本庫
如果是想把Android當前主線上最新版本的所有的sourcecode拿下來，我們需要repo的協助。
先建立一個目錄，比如~/android，進去以後用repo
init命令即可。
repo init -u
git://android.git.kernel.org/platform/manifest.git
這個過程會持續很長的時間（至少可以好好睡一覺），具體要多少時間就取決於網路條件了
最後會看到
repo initialized in /android這樣的提示，就說明本地的版本庫已經初始化完畢，並且包含了當前最新的sourcecode。

如果想拿某個branch而不是主線上的代碼，我們需要用-b參數制定branch名字，比如：
repo init -u
git://android.git.kernel.org/platform/manifest.git -b cupcake

另一種情況是，我們只需要某一個project的代碼，比如kernel/common，就不需要repo了，直接用Git即可。
git
clone
git://android.git.kernel.org/kernel/common.git
這也需要不少的時間，因為它會把整個Linux
Kernel的代碼複製下來。

如果需要某個branch的代碼，用git
checkout即可。比如我們剛剛拿了kernel/common.get的代碼，那就先進入到common目錄，然後用下面的命令：
git
checkout origin/android-goldfish-2.6.27 -b
goldfish
這樣我們就在本地建立了一個名為goldfish的android-goldfish-2.6.27分支，代碼則已經與android-goldgish-2.6.27同步。我們可以通過git
branch來列出本地的所有分支。

4、同步版本庫
使用epo
sync命令，我們把整個Android代碼樹做同步到本地，同樣，我們可以用類似
repo sync project1
project2 …
這樣的命令來同步某幾個項目

如果是同步Android中的單個項目，只要在項目目錄下執行簡單的
git pull
即可。

5、通過GitWeb下載代碼
另外，如果只是需要主線上某個項目的代碼，也可以通過GitWeb下載，在shortlog利用關鍵字來搜尋特定的版本，或者找幾個比較新的tag來下載還是很容易的。

Git最初是為Linux核心開發而設計，所以對其他平台的支援並不好，尤其是Windows平台，必須要有Cygwin才可以。現在，得益於msysgit項目，我們已經可以不需要Cygwin而使用Git了。另外，Git
Extensions是一個非常好用的Windows Shell擴充，它能與資源管理員緊密整合，甚至提供了Visual
Studio外掛程式。它的官方網站上有一分不錯的說明文檔，感興趣的朋友可以看一看。

至於Git的參考文檔，我推薦Git
Magic，這裡還有一個Git
Magic的中文版。