Git
submodules

Een submodule toevoegen

Je kunt een andere Git-repository als map in je project opnemen, bijgehouden door Git:

$ git submodule add https://github.com/jquery/jquery.git

U moet het nieuwe .gitmodules bestand toevoegen en vastleggen; dit vertelt Git welke submodules moeten worden gekloond wanneer de git submodule update wordt uitgevoerd.

Een Git-repository met submodules klonen

Wanneer u een repository clone die submodules gebruikt, moet u deze initialiseren en bijwerken.

$ git clone --recursive https://github.com/username/repo.git

Hiermee worden de submodules waarnaar wordt verwezen gekloond en in de juiste mappen geplaatst (inclusief submodules in submodules). Dit komt overeen met het uitvoeren van git submodule update --init --recursive onmiddellijk nadat de kloon is voltooid.

Een submodule bijwerken

Een submodule verwijst naar een specifieke commit in een andere repository. Als u de exacte status wilt controleren waarnaar wordt verwezen voor alle submodules, voert u uit

git submodule update --recursive

Soms wilt u in plaats van de status waarnaar wordt verwezen, uw lokale kassa bijwerken naar de nieuwste status van die submodule op een afstandsbediening. U kunt met één opdracht alle submodules naar de nieuwste status op de afstandsbediening bekijken

git submodule foreach git pull <remote> <branch>

of gebruik de standaard git pull argumenten

git submodule foreach git pull

Merk op dat dit gewoon uw lokale werkkopie bijwerkt. Als je git status wordt de submodule-directory als vies weergegeven als deze is gewijzigd vanwege deze opdracht. Om in plaats daarvan uw repository bij te werken om naar de nieuwe status te verwijzen, moet u de wijzigingen doorvoeren:

git add <submodule_directory>
git commit

Er kunnen enkele wijzigingen zijn die conflicten kunnen hebben als je git pull zodat je git pull kunt gebruiken git pull --rebase om je wijzigingen naar boven terug te spoelen, meestal vermindert dit de kans op conflicten. Ook trekt het alle takken naar lokaal.

git submodule foreach git pull --rebase

Om de laatste status van een specifieke submodule af te rekenen, kunt u het volgende gebruiken:

git submodule update --remote <submodule_directory>

Een submodule instellen om een tak te volgen

Een submodule wordt altijd uitgecheckt bij een specifieke commit SHA1 (de "gitlink", speciale vermelding in de index van de bovenliggende repo)

Maar men kan vragen om die submodule bij te werken naar de laatste commit van een tak van de submodule externe repo.

In plaats van in elke submodule te gaan, een git checkout abranch --track origin/abranch, git pull , kun je eenvoudig doen (vanuit de ouder-repo) een:

git submodule update --remote --recursive

Omdat de SHA1 van de submodule zou veranderen, zou je dat nog moeten volgen met:

git add .
git commit -m "update submodules"

Dat veronderstelt dat de submodules waren:

• ofwel toegevoegd met een tak om te volgen:

    git submodule -b abranch -- /url/of/submodule/repo
  

• of geconfigureerd (voor een bestaande submodule) om een tak te volgen:

    cd /path/to/parent/repo
    git config -f .gitmodules submodule.asubmodule.branch abranch
  

Een submodule verwijderen

$ git submodule deinit the_submodule
$ git rm the_submodule 

Een submodule verplaatsen

$ git mv old/path/to/module new/path/to/module

Dit voorbeeld van Stack Overflow , van Axel Beckert