git version 2.11.0 (Apple Git-81)

工作中會遇到這種情況,多個專案引用了同一套程式碼 A,這套程式碼A修改後還需要在多個專案中同步,如果專案是 git 管理,那就需要在每個專案中嵌入一個子模組,這個子模組就是 A


git 子模組允許你將一個 Git 倉庫作為另一個 Git 倉庫的子目錄。 它能讓你將另一個倉庫克隆到自己的專案中，同時還保持提交的獨立。

1:新增子模組
如果我們要嵌入一個子模組,就必須呼叫 submodule add 命令,並制定該模組的 倉庫路徑和模組所在的目錄名

> git submodule add [email protected]
 
:langzuxiaozi/ExtractSms.git sub

這樣一來,模組版本庫就會被完整地克隆到制定的目錄中(並且它也會建立屬於它自己的.git目錄),主版本庫中的.gitmodules檔案也將被同步建立或更新
然後還需要將新的子模組註冊到.git/config檔案中.

>git submodule init

目前子模組指向的是預設分支的 HEAD, 如果需要選擇子模組的版本, 那就需要用 checkout 命令來選擇一下相應的版本

>cd sub
>git checkout v1.0
>cd ..

然後將.gitmodules 檔案和子目錄新增到提交中

>git add .gitmodules
>git add sub
>git commit -m "Submodule added"
>git push
 

2:克隆帶有子模組的專案

要克隆一個帶有子模組的專案需要在執行 git clone 命令之後 需要初始化子模組和更新子模組,要不子模組的目錄內容是空的

>git submodule init
>git submodule update

現在子模組目錄就有內容了.當然也可以執行遞迴命令

>git clone --recursive [email protected]:langzuxiaozi/ExtractSms.git

3:子模組倉庫有更新,要用最新的子模組程式碼

在許多開發專案中,我們通常都希望主專案所整合的始終是子模組的當前最新版本.
git 的子模組不支援這種想法,子模組引用的只是模組版本庫中的某一次提交,模組版本庫中隨後的新提交併不會自動記錄到主版本庫中.所以需要我們顯示的修改
更新子模組

>cd sub
>git fetch
>git checkout v1.0
>cd ..

最後將新提交更新到模組目錄中.

>git add sub
>git commit -m "New version of the submodule"
>git push

4:修改子模組檔案內容後,提交更新

如果在工程中修改了子模組的檔案,那就進入到主版本庫中的子模組目錄提交併推送

>cd sub
>git add jni_common.h
>git commit -m "Changed submodule"
>git push
>cd ..

這個時候去子模組的倉庫看,就能看的這次的修改了,但是還沒完,主機板本的倉庫還沒更新呢,
先看一下當前主版本中子模組被引用的雜湊值

>git submodule status
+447ff22adb9ed9a72e4be7cdfa7ebe4f5ba2af0a sub (heads/master)

這個雜湊值是和子模組中倉庫中最新提交的雜湊值是一致的.下面更新主版本的倉庫

>git add sub
>git commit -m "New version of submodule"
>git push

5:修改子模組的 url

開啟目錄下的.gitmodules檔案,修改對應模組的 url,然後執行命令

>git submodule sync
>git commit -am "Update submodule url."
>git push

6:刪除子模組

首先逆初始化子模組目錄,執行後目錄內容為空

>git submodule deinit sub

然後刪除.gitmodules中的sub模組資訊 然後提交

>git rm --cached sub
>git git commit -am "Remove a submodule."
>git push

7:Jenkins配置 git 子模組
首先 git 的證書 是在 Jinkens 上配的才可以

Additional Behaviours -> Add -> Advanced sub-modules behaviours 選中
Recursively update submodules 和 Use credentials from default remote of parent repository
完成.