git submodule commit/push/pull

Question

我想使用git submodule。

我需要把我的變化推到我的項目的步驟是從子模塊目錄

1. 添加/提交/推
2. 添加/提交從父目錄/推

我需要採取措施來拉動我的項目變化。從父目錄 從父目錄

混帳子模塊更新

步驟

1. 混帳拉從原來的回購從

   1. 混帳拉更新子模塊子模塊目錄

   我擔心的是http://git-scm.com/book/en/Git-Tools-Submodules

   以下exerpt的問題是，你通常並不想在一個分離的頭 的環境中工作，因爲它很容易失去的變化。如果您執行初始的 子模塊更新，請在該子模塊目錄中提交而不創建 分支，然後再次從 超級項目中運行git子模塊更新，但不提交（更新/提交/更新將會失去改變？）Git會在沒有告訴您的情況下覆蓋您的更改 。從技術上講，你不會失去工作， 但你不會有一個分支指向它，所以它會有點難以檢索 。

   要避免此問題，請在使用git checkout -b工作或類似工具在子模塊 目錄中工作時創建分支。當你 做子模塊第二次更新時，它仍然會恢復你的工作，但至少你有一個返回的指針。

   我打算修改子模塊，不想搞亂，上面的文檔簡單地提到了丟失改變的可能性，我不明白什麼可能會導致損失。

   我不知道什麼額外的步驟超過我上面列出我需要採取以防止 損失。 特別是幾個團隊成員修改子模塊，他們需要什麼不要搞亂？

Answer 1

我想與您分享我的經驗，與您一起嘗試解決類似問題的Visual Studio解決方案中的外部項目。我對git比較陌生，所以如果任何人有任何建設性的批評，我會很感激。

如果您使用的是Visual Studio，Git源代碼管理提供程序擴展是免費的（http://visualstudiogallery.msdn.microsoft.com/63a7e40d-4d71-4fbb-a23b-d262124b8f4c），並且在我測試它時似乎遞歸提交子模塊。但是我不想依賴擴展（我也認爲很好地瞭解引擎蓋下發生了什麼），但是我在開發中使用VS Web Developer Express。因此我不得不弄清這些命令，並在下面添加了一些註釋。

注意

如果您還沒有這樣做，有一個徹底讀通過http://git-scm.com/book/en/Git-Tools-Submodules。有幾個警告，我會回到這個頁面。如果您嘗試在不閱讀本文的情況下使用子模塊進行操作，您將很快就會頭痛。

我的做法是遵循本教程中，有一些額外設施：http://blog.endpoint.com/2010/04/git-submodule-workflow.html

一旦你有你上層項目初始化（如git init & & git remote add origin ...），開始添加你的子模塊，像這樣：

git submodule add git://github.com/you/extension1.git extension 
git submodule init 
git submodule update 

檢查你的.gitmodules文件反映了這一點，例如

[submodule "extension1"] 
     path = extension 
     url = git://github.com/you/extension1.git 

切換到您的子模塊目錄（即cd extension）。兼營：

git fetch #I use fetch here - maybe you can use pull? 
git checkout -b somebranchname #See the Git-Tools-Submodules link above for an explanation of why you need to branch 

我在這裏做了更改的README.txt，所以我可以提交它（也因此我有什麼，我在此承諾做一個記錄），然後COMMITED模塊應用分支（仍然在子模塊目錄）：

git add . 
git commit -a -m "Branching for extension submodule" 

現在進入上層項目（即cd ..）。您還需要在這裏提交（如果你看看我所提到的git的子模塊頁面也解釋了爲什麼這是必要的）：

git status #will show you that your submodule has been modified 
git commit -a -m "Commiting submodule changes from superproject" 

現在我們可以recusively推動我們的項目，像這樣如果需要的話：

git push --recurse-submodules=on-demand 

您需要對所有子模塊執行一次上述步驟。

一旦你完成了這對所有子模塊，並開始製作要提交和推送更改，您可以使用：

git submodule foreach 'git add .' #recursively add files in submodules 

Unfortunaly我還沒有找到一種方法，而無需使用類似遞歸提交git-slave（任何人？），因此您需要進入每個子模塊目錄並對剛剛添加的文件運行常規提交。在上層項目：

git status #tells you that `extension` submodule has been modified 
cd extension 
git commit -a -m "Commiting extension changes in superproject edit session" 

一旦子模塊commiting，您還需要提交上層項目（再次），所以：

cd .. 
git add . 
git commit -a -m "Altered extension submodule" 
git status #should now show 'working directory clean', otherwise commit other submodules in the same manner 

這可以讓有點惱人的（因爲你最終提交兩次），但一旦你意識到它實際上並不壞（因爲它迫使你檢查你在每個項目中提交的內容）。只是我的看法 - 如果你已經將一些超級項目的功能分離到了子模塊中，它應該與你的其他項目分開工作（所以在不同時間提交它們，而煩人不是世界的盡頭）。

現在我們可以把一次...

git push --recurse-submodules=on-demand 

如果你再進入到您的子模塊並再次嘗試推，你會發現它不會做任何事情的最新提交已是推。

爲超級項目克隆（或使用遠程原點）也可能相當混亂 - 例如需要在git submodule init後兩次運行git submodule update。閱讀http://git-scm.com/book/en/Git-Tools-Submodules中的「用子模塊克隆項目」部分。

克隆我的超級項目時引起我注意的事情是獲取子模塊的最新更改。見Easy way pull latest of all submodules

我的這個變體是使用簽出的子模塊一個「發展」分支（但你可以調用它任何你想要的），然後在上層項目使用：

git submodule foreach git pull origin development 

當我設置這件事我也交換到我想我的變化推動對檢查出的子模塊，像這樣的分支：

cd extension 
git checkout -b development #This will tell you this is a new branch, but I believe this means a new branch of the local git repository - this will get pushed to the 'development' branch 
#Make your changes, commit etc. 

我可以確認的是，當我按照上面的步驟，在克隆/遠程更改子模塊原始項目（推動時）出現在其他克隆中es /遠程同一項目的起源（不要忘記最後一個子模塊拉命令）。

我希望這對你有一些用處。