自動目錄
有時寫的專案中還有引入另一個GIT專案,(不管是自己的其他專案或是別人的),簡易的作法是到該目錄下clone 一個進來:
簡單的來說:為了管理自己專案中的其他專案,就得用git submodule 這個功能:
--我的專案
L 另一個專案
另一個專案可是自己或是別人的專案
但這樣的就會遇到2個問題:
1當另一個專案有更新時,我的專案還得另外到那個目錄作update(pull)的動作來確保更新。
2 在提交到伺服器時,另一個專案不會一併提交。當別人取回時,會得到一個空目錄。
因此為了維護我的專案中的別人的專案,得使用GIT提供的次模組功能 (submodule)
一、在我的專案中要加入一個別人的專案
例如我要拉ThirdParty-Project這個專案到我的目錄libs/third下,可下指令
git submodule add GIT來源 目標目錄
這裡的目錄 libs/third 不能先建,git會自己建立。建立完git 會產生一個檔案 .gitmodules,內容大概是這樣:
此檔會自動建立
同時次模組中的檔案也會被抓回來,未來在佈建或是更新時,次模組中的內容也會一併更新
二、我們把專案寫好發佈到伺服器
就算有次模組,自己的模組發布方法也沒有改變,-m後面是註解;-a是新增新的檔案
三、別人拉回我們的專案
$ git pull origin master
(origin:視各位的reposity設定,master:視各位的分枝而不同)
會發現別人的專案這個目錄是空目錄
$ cd libs/third
$ ls
一片空,別緊張,因為我們還沒有初始化這個次模組
四、初始化並更新拉回的專案
在你git的最上層目錄執行
$ git submodule init
$ git submodule update
這樣我們取回的複本,就能夠順利另外取得第三方的專案內容了。
錯誤及排除
一、當建立次模組發生錯誤 'path/to/' already exists in the index[1]
這是因為你的目錄 path/to/已在git索引之中你需要將他先移除:
$ git rm -r path/to
to本身是目錄,後面那個 '/'有加沒加沒關係。移除完重建
二、You need to run this command from the toplevel of the working tree.
進行次模組操作時,要到最上層目錄操作,也就是 .git/ 目錄存在的那層
只要到你原本下git init那層執行即可
參考資料
[1] https://codertw.com/%E4%BA%BA%E5%B7%A5%E6%99%BA%E6%85%A7/134110/
原文 2013-12-03 15:41:36