Git 多項目管理之奇淫技巧
隨着項目業務的豐富,結構層次的複雜,單一的項目管理手段已經顯得越來越力不從心。尤其是插件化開發、熱修復盛行的今天。以下介紹兩種我個人比較推薦的 git 多項目管理的方式。
Repo
Android 使用Git作爲代碼管理工具,開發了Gerrit進行代碼審覈以便更好的對代碼進行集中式管理,還開發了Repo命令行工具,它是一個Python腳本,對Git部分命令進行封裝,簡化了對多個Git版本庫的管理,將百多個Git庫有效的進行組織。
簡單點說:Repo是基於git的倉庫管理工具,是一個python腳本 ,它可以支持對多個Git廠庫進行管理。
創建清單
<?xml version="1.0" encoding="utf-8"?>
<manifest>
<remote name="origin"
fetch="https://github.com/cc347504377/" />
<default revision="master"
remote="origin"
sync-j="4" />
<project path="kotlinLibrary" name="kotlinLibrary" revision="master">
<copyfile src="BuildScript/build.gradle" dest="build.gradle" />
</project>
<project .....></project>
</manifest>
清單創建好命名爲default.xml
,然後上傳到git倉庫,後續步驟會用到該倉庫的地址。可以單獨上傳也支持和項目一起打包上傳,總之需要保證該地址的倉庫中根目錄下存在該清單文件即可。
下載
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
初始化
cd <workspace>
mkdir <projectname>
repo init –u <URL> [<OPTIONS>]
URL:指定manifest倉庫地址
選項:
-u: 指定連接到的manifest倉庫地址
-m: 選擇倉庫中某個manifest文件,如果沒有設置,就使用default.xml
-b: 選擇一個maniest倉庫中的一個特殊的分支或修正版本
拉代碼
repo sync
選項:
-j : 多任務,一般8核心可以開到16任務,過多會起反作用
-c: 只下載當前分支代碼
-d: 讓工程回退到manifest指定的版本
-f: 如果某個工程同步失敗,繼續同步
切本地分支
repo start <localbranch> --all
常用命令
repo命令還有很多,可以通過命令 repo help 顯示所有的命令,有興趣的同學可以自行查閱。在這就不一一列舉了。
另外 repo help 來獲取有關某個命令的信息,例如,以下命令會生成 repo init 參數的說明和選項列表。
repo help init
Submodule
當一個 git 項目需要包含其他支持 git 項目源碼時使用的功能,作用是讓多個項目獨立存在,且主項目可以使用另一個支持項目。
添加子項目
git submodule add <submodule_url>
添加子項目後會出現.gitmodules
的文件,這是一個配置文件,記錄 mapping between the project’s URL and the local subdirectory。且該文件在 git 版本控制中,這樣其他參與項目的人才能知道 submodule projects 的情況。
初始化及拉取代碼
git submodule init # 初始化本地.gitmodules文件
git submodule update # 同步遠端submodule源碼
在獲取包含submodule
主項目時,pull
和 clone
操作的時候不會同時獲取 submodule 的源碼,需要執行本地.gitmodules初始化的命令,再同步遠端submodule源碼。如果希望 clone main project 的時候包含所有submodules,可以使用下面的命令:
git clone --recurse-submodules <main_project_url> # 獲取主項目和所有子項目源碼
.gitmodule
[submodule <submodule_name>]
path = <local_directory>
url = <remote_url>
branch = <remote_update_branch_name>
常用命令
# 更新submodule源碼,默認更新的branch是master,如果要修改branch,在.gitmodule中設置
git submodule update --remote <submodule_name>
# 更新所有submodule源碼,默認更新.gitmodule中設置的跟蹤分支,未設置則跟蹤master
git submodule update --remote
# 當submodule commits提交有問題的時候放棄整個push
git push --recurse-submodules=check
# 分開提交submodule和main project
git push --recurse-submodules=on-demand
# submodules的命令很長,爲提升效率,可以創建alias,記錄在.git/config路徑下
git config alias.spush 'push --recurse-submodules=on-demand'
git config alias.supdate 'submodule update --remote --merge'
總結
-
Repo
:多項目所屬關係爲平級且數量較多,需要更加靈活的管理,並且需要一些特殊的功能,例如:控制某個項目中文件位置。 -
Submodule
:一個項目中依賴某個小項目且數量較少,不需要非常靈活的管理。