Gérer les sous-modules
Un sous-module est un autre référentiel épinglé dans le vôtre lors d'une validation spécifique. GitTree les répertorie avec leur état (non initialisés, à jour, commit différent, en conflit) et les ajoute, initialise, met à jour, ouvre, modifie et supprime.
Fonctionne dans GitTree Gratuit : toutes les fonctionnalités Git locales, une fois connecté.
Sur cette page
Avant de commencer
- Un référentiel avec des sous-modules (un fichier
.gitmodules) ou celui auquel vous souhaitez ajouter un sous-module.
Où le trouver
- La section Submodules du panneau de gauche ; cliquez avec le bouton droit sur un sous-module pour ses actions.
- La palette de commandes : Add Submodule… et Update All Submodules.
| Action | macOS | Windows et Linux |
|---|---|---|
| La palette de commandes | ⌘⇧P | Ctrl+Shift+P |
Mesures
Voir leur état
Développez Submodules. Chacun affiche not initialised, up to date, different commit ou conflicted.
Initialiser et mettre à jour
Après le clonage, choisissez Initialise Submodule et Update Submodule, ou Update All Submodules pour chacun. Ils sont extraits lors de la validation des enregistrements de votre référentiel.
Travailler à l'intérieur d'un
Choisissez Open Submodule in a New Tab pour le valider, le créer et le pousser comme n'importe quel référentiel.
Ajoutez-en un
Exécutez Add Submodule… : tapez le Repository URL, le Path in this repository et éventuellement le Branch to follow. Validez ensuite le nouveau sous-module et
.gitmodules.
Résultat attendu
Vos sous-modules sont extraits aux bonnes validations et leurs modifications sont validées dans votre référentiel comme n'importe quel fichier.
Modifier, synchroniser ou supprimer
- Edit Submodule… modifie son URL ou sa branche ; engagez
.gitmodulesà le partager. - Sync Submodule URL copie une URL modifiée de
.gitmodulesdans votre configuration. - Remove Submodule… le supprime ; son historique est conservé dans
.git/modules.
Si quelque chose ne va pas
Un sous-module affiche different commit
Son extraction diffère de la validation enregistrée dans votre référentiel. Update Submodule extrait celui enregistré ; ou validez le nouveau commit si vous l'avez déplacé volontairement.
Questions
Les sous-modules sont-ils inclus dans une archive exportée ?
Non. Leurs dossiers sont exclus des archives (exporter une archive).