Як налаштувати і використовувати підмодулі Git submodules для керування залежностями?
Підмодулі в Git є механізмом, який дозволяє вбудувати один незалежний репозиторій всередину іншого репозиторію як піддиректорію. Це особливо корисно, коли ваш проєкт залежить від сторонньої бібліотеки або загального модуля, який розвивається окремо, але ви хочете мати можливість фіксувати точну робочу версію цієї залежності прямо у своєму коді.
Для додавання нового підмодуля в проєкт використовується команда git submodule add, за якою слідує URL-адреса віддаленого репозиторію бібліотеки та шлях, за яким вона повинна розташовуватися у вашому проєкті. Після виконання цієї команди Git клонує вказаний репозиторій всередину вашого проєкту і створює спеціальний файл конфігурації .gitmodules, де зберігаються метадані про підключені залежності.
Важливо розуміти, що при клонуванні основного репозиторію, який містить підмодулі, папки з підмодулями за замовчуванням залишаються порожніми. Щоб завантажити їхній вміст, розробнику після клонування необхідно виконати ініціалізацію та оновлення підмодулів за допомогою команди git submodule update --init --recursive. Флаг recursive гарантує, що будуть завантажені навіть вкладені підмодулі, якщо вони є.
Робота з кодом всередині підмодуля має свої особливості. Коли ви заходите в папку з підмодулем, ви потрапляєте в стан окремого незалежного репозиторію з власним вказівником HEAD. Якщо ви внесли зміни в код підмодуля і закомітили їх там, основний проєкт не підхопить ці зміни автоматично. У батьківському репозиторії просто оновиться хеш коміту, на який посилається підмодуль, і цей новий хеш потрібно буде зафіксувати окремим комітом.
Для оновлення всіх підмодулів у проєкті до актуальних версій з віддалених репозиторіїв використовується команда git submodule update --remote. Це дозволяє швидко підтягувати останні зміни зовнішніх залежностей. Видалення підмодуля вимагає ручного видалення запису з конфігураційного файлу .gitmodules, очищення кешу Git і видалення самої папки із залежністю з диска.