Git Submodule vous permettent d'intégrer un référentiel Git dans un autre référentiel Git en tant que sous-répertoire. Ceci est utile lorsque vous avez un projet qui dépend d'une bibliothèque ou d'un composant externe. Voici un guide de base sur la façon d'utiliser Git Submodule:
Ajouter Submodule
Pour ajouter un Submodule au dépôt actuel, accédez au répertoire racine du dépôt et exécutez la commande suivante :
git submodule add <URL_repository> <destination_path>
où <URL_repository> est l'URL du référentiel que vous souhaitez intégrer et <destination_path> est le chemin d'accès au sous-répertoire du référentiel actuel pour stocker les fichiers Submodule.
Cloner Submodule
Une fois que vous avez ajouté un Submodule au référentiel, vous devez le cloner dans le référentiel existant. Pour cloner le Submodule, exécutez les commandes suivantes :
git submodule init
git submodule update
La git submodule init commande initialise Submodule et crée un lien vers le référentiel contenant le sous-module. La git submodule update commande télécharge le code source du Submodule et le met à jour dans le sous-répertoire correspondant
.
Travailler avec Submodule
Une fois le Submodule cloné dans le référentiel, vous pouvez l'utiliser en tant que référentiel Git indépendant. Vous pouvez vérifier les branches, créer commits et pousser dans le fichier Submodule.
Pour mettre à jour le sous-module dans le référentiel existant, exécutez la commande :
git submodule update --remote
Cette commande télécharge les dernières modifications du Submodule référentiel et les met à jour dans le sous-répertoire correspondant.
Retirer Submodule
Si vous n'avez plus besoin de Submodule, vous pouvez le supprimer en exécutant les commandes suivantes :
git submodule deinit <submodule_name>
git rm <submodule_path>
Remplacez <submodule_name> par le nom du Submodule et <submodule_path> par le chemin d'accès au sous-répertoire contenant le Submodule. Ensuite, vous devez valider et pousser ce changement.
Git Submodule vous aider à gérer les dépendances et à intégrer facilement des sous-dépôts dans votre projet principal. Il vous permet de conserver un code source distinct pour le Submodule et de le mettre à jour facilement en cas de besoin.