Git 多項目管理之奇淫技巧

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主項目時,pullclone 操作的時候不會同時獲取 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一個項目中依賴某個小項目且數量較少,不需要非常靈活的管理

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章