Git Submodule pozwalają osadzić repozytorium Git w innym repozytorium Git jako podkatalog. Jest to przydatne, gdy masz projekt zależny od biblioteki lub komponentu zewnętrznego. Oto podstawowy przewodnik, jak używać Git Submodule:
Dodać Submodule
Aby dodać Submodule do bieżącego repozytorium, przejdź do katalogu głównego repozytorium i uruchom następującą komendę:
git submodule add <URL_repository> <destination_path>
gdzie <URL_repository> jest adresem URL repozytorium, które chcesz osadzić, oraz <destination_path> ścieżką do podkatalogu w bieżącym repozytorium, w którym przechowywane są pliki Submodule.
Klon Submodule
Po dodaniu Submodule do repozytorium musisz sklonować go do istniejącego repozytorium. Aby sklonować Submodule, uruchom następujące polecenia:
git submodule init
git submodule update
Polecenie git submodule init inicjuje Submodule i tworzy łącze do repozytorium zawierającego Submoduł. Polecenie git submodule update pobiera kod źródłowy programu Submodule i aktualizuje go do odpowiedniego podkatalogu
.
Praca z Submodule
Po Submodule sklonowaniu do repozytorium możesz pracować z nim jako niezależnym repozytorium Git. Możesz kasować gałęzie, tworzyć commits i wciskać wewnątrz Submodule.
Aby zaktualizować Submoduł w istniejącym repozytorium, uruchom komendę:
git submodule update --remote
To polecenie pobiera najnowsze zmiany z Submodule repozytorium i aktualizuje je w odpowiednim podkatalogu.
Usunąć Submodule
Jeśli nie potrzebujesz już programu Submodule, możesz go usunąć, uruchamiając następujące polecenia:
git submodule deinit <submodule_name>
git rm <submodule_path>
Zastąp <submodule_name> nazwą Submodule i <submodule_path> ścieżką do podkatalogu zawierającego plik Submodule. Następnie musisz zatwierdzić i wypchnąć tę zmianę.
Git Submodule pomagają zarządzać zależnościami i łatwo integrować podrepozytoria z głównym projektem. Pozwala na utrzymanie osobnego kodu źródłowego Submodule i łatwą aktualizację w razie potrzeby.