Как переместить существующий подмодуль Git в репозиторий Git?

Примечание. Как упоминалось в комментариях, этот ответ относится к шагам, необходимым для более старых версий git. Git теперь имеет встроенную поддержку перемещения подмодулей:

Начиная с git 1.8.5, git mv old/submod new/submod работает должным образом и выполняет всю работу за вас. Возможно, вы захотите использовать git 1.9.3 или новее, потому что он включает исправления для перемещения подмодуля.

Этот процесс аналогичен удалению подмодуля (см. Как удалить подмодуль?):

1. Отредактируйте .gitmodules и соответствующим образом измените путь к подмодулю и поместите его в индекс с помощью git add .gitmodules.
2. При необходимости создайте родительский каталог для нового местоположения подмодуля (mkdir -p new/parent).
3. Переместите все содержимое из старого каталога в новый (mv -vi old/parent/submodule new/parent/submodule).
4. Убедитесь, что Git отслеживает этот каталог (git add new/parent).
5. Удалите старый каталог с помощью git rm --cached old/parent/submodule.
6. Переместите каталог .git/modules/old/parent/submodule со всем его содержимым в .git/modules/new/parent/submodule.
7. Отредактируйте файл .git/modules/new/parent/config, убедитесь, что элемент рабочего дерева указывает на новые местоположения, поэтому в этом примере это должно быть worktree = ../../../../../new/parent/module. Обычно в этом месте прямого пути должно быть на два .. больше, чем каталогов.

8. Отредактируйте файл new/parent/module/.git, убедитесь, что путь в нем указывает на правильное новое место в папке .git основного проекта, поэтому в этом примере gitdir: ../../../.git/modules/new/parent/submodule.

   git status для меня результат выглядит так:

   # On branch master
   # Changes to be committed:
   #   (use "git reset HEAD <file>..." to unstage)
   #
   #       modified:   .gitmodules
   #       renamed:    old/parent/submodule -> new/parent/submodule
   #
   

9. Наконец, зафиксируйте изменения.

Самый современный ответ, взятый из комментария Валлорика выше:

1. Выполните обновление до Git 1.9.3 (или 2.18, если подмодуль содержит вложенные подмодули < / а>)
2. git mv old/submod new/submod
3. Впоследствии .gitmodules и каталог подмодулей уже подготовлены для фиксации (вы можете проверить это с помощью git status.)
4. Зафиксируйте изменения с помощью git commit, и все готово!

В моем случае я хотел переместить подмодуль из одного каталога в подкаталог, например «AFNetworking» -> «ext / AFNetworking». Я выполнил следующие шаги:

1. Отредактируйте .gitmodules, изменив имя и путь подмодуля на "ext / AFNetworking"
2. Переместите каталог git подмодуля из ".git / modules / AFNetworking" в ".git / modules / ext / AFNetworking"
3. Перенести библиотеку из AFNetworking в ext / AFNetworking
4. Отредактируйте ".git / modules / ext / AFNetworking / config" и исправьте строку [core] worktree. Мой изменен с ../../../AFNetworking на ../../../../ext/AFNetworking
5. Отредактируйте "ext / AFNetworking / .git" и исправьте gitdir. Мой изменен с ../.git/modules/AFNetworking на ../../git/modules/ext/AFNetworking
6. git add .gitmodules
7. git rm --cached AFNetworking
8. git submodule add -f <url> ext/AFNetworking

Наконец, я увидел в статусе git:

matt$ git status
# On branch ios-master
# Changes to be committed:
#   (use "git reset HEAD <file>..." to unstage)
#
#   modified:   .gitmodules
#   renamed:    AFNetworking -> ext/AFNetworking

И вуаля. Приведенный выше пример не меняет глубину каталога, что сильно влияет на сложность задачи, и не меняет имя подмодуля (что, возможно, на самом деле не обязательно, но я сделал это, чтобы соответствовать тому, что произойдет, если я добавлю новый модуль по этому пути.)

[Обновление: 2014-11-26] Как прекрасно резюмирует Яр, прежде чем что-либо делать, убедитесь, что вы знаете URL-адрес подмодуля. Если он неизвестен, откройте .git/.gitmodules и проверьте ключ submodule.<name>.url.

Что сработало для меня, так это удалить старый подмодуль с помощью git submodule deinit <submodule>, за которым следует git rm <submodule-folder>. Затем снова добавьте подмодуль с новым именем папки и выполните фиксацию. Проверка статуса git перед фиксацией показывает, что старый подмодуль переименован в новое имя и изменен .gitmodule.

$ git submodule deinit foo
$ git rm foo
$ git submodule add https://bar.com/foo.git new-foo
$ git status
renamed:    foo -> new-foo
modified:   .gitmodules
$ git commit -am "rename foo submodule to new-foo"

Кажется, уловка заключается в понимании того, что каталог .git для подмодулей теперь хранится в главном репозитории под .git/modules, и каждый подмодуль имеет файл .git, указывающий на него. Вот процедура, которая вам сейчас нужна:

• Переместите субмодуль в его новый дом.
• Отредактируйте файл .git в рабочем каталоге подмодуля и измените путь, который он содержит, так, чтобы он указывал на правильный каталог в каталоге .git/modules главного репозитория.
• Войдите в каталог .git/modules главного репозитория и найдите каталог, соответствующий вашему подмодулю.
• Отредактируйте файл config, обновив путь worktree, чтобы он указывал на новое расположение рабочего каталога подмодуля.
• Отредактируйте файл .gitmodules в корне главного репозитория, обновив путь к рабочему каталогу подмодуля.
• git add -u
• git add <parent-of-new-submodule-directory> (Важно, чтобы вы добавляли родительский элемент, а не сам каталог подмодуля.)

Несколько примечаний:

• Строки [submodule "submodule-name"] в .gitmodules и .git/config должны совпадать друг с другом, но не соответствовать ничему другому.
• Рабочий каталог подмодуля и каталог .git должны правильно указывать друг на друга.
• Файлы .gitmodules и .git/config должны быть синхронизированы.

Строка в кавычках после «[подмодуль» не имеет значения. Вы можете изменить его на "foobar", если хотите. Он используется для поиска соответствующей записи в ".git / config".

Следовательно, если вы внесете изменения до того, как запустите «git submodule init», все будет нормально. Если вы внесете изменение (или получите изменение путем слияния), вам нужно будет либо вручную отредактировать .git / config, либо снова запустить «git submodule init». Если вы сделаете последнее, у вас останется безобидная "застрявшая" запись со старым именем в .git / config.

Вы можете просто добавить новый подмодуль и удалить старый подмодуль с помощью стандартных команд. (должен предотвратить любые случайные ошибки внутри .git)

Пример настройки:

mkdir foo; cd foo; git init; 
echo "readme" > README.md; git add README.md; git commit -m "First"
## add submodule
git submodule add git://github.com/jquery/jquery.git
git commit -m "Added jquery"
## </setup example>

Например, переместите jquery в vendor / jquery / jquery:

oldPath="jquery"
newPath="vendor/jquery/jquery"
orginUrl=`git config --local --get submodule.${oldPath}.url`

## add new submodule
mkdir -p `dirname "${newPath}"`
git submodule add -- "${orginUrl}" "${newPath}"

## remove old submodule
git config -f .git/config --remove-section "submodule.${oldPath}"
git config -f .gitmodules --remove-section "submodule.${oldPath}"
git rm --cached "${oldPath}"
rm -rf "${oldPath}"              ## remove old src
rm -rf ".git/modules/${oldPath}" ## cleanup gitdir (housekeeping)

## commit
git add .gitmodules
git commit -m "Renamed ${oldPath} to ${newPath}"

Бонусный метод для больших подмодулей:

Если подмодуль большой и вы предпочитаете не дожидаться клона, вы можете создать новый подмодуль, используя старый в качестве источника, а затем переключить источник.

Пример (используйте тот же пример настройки)

oldPath="jquery"
newPath="vendor/jquery/jquery"
baseDir=`pwd`
orginUrl=`git config --local --get submodule.${oldPath}.url`

# add new submodule using old submodule as origin
mkdir -p `dirname "${newPath}"`
git submodule add -- "file://${baseDir}/${oldPath}" "${newPath}"

## change origin back to original
git config -f .gitmodules submodule."${newPath}".url "${orginUrl}"
git submodule sync -- "${newPath}"

## remove old submodule
...

Данное решение у меня не сработало, но похожая версия сработала ...

Это с клонированным репозиторием, поэтому репозитории git подмодулей содержатся в директории верхнего уровня репозиториев .git. Все катионы из верхнего репозитория:

1. Отредактируйте .gitmodules и измените параметр "path =" для рассматриваемого подмодуля. (Не нужно ни изменять метку, ни добавлять этот файл в индекс.)

2. Отредактируйте .git / modules / name / config и измените параметр "worktree =" для рассматриваемого подмодуля.

3. бегать:

   mv submodule newpath/submodule
   git add -u
   git add newpath/submodule
   

Интересно, имеет ли это значение, если репозитории являются атомарными или относительными подмодулями, в моем случае это было относительным (подмодуль / .git - это ссылка на topproject / .git / modules / submodule)

Просто используйте сценарий оболочки git-submodule-move.

Я только вчера прошел через это испытание, и этот ответ сработал отлично. Вот мои шаги, для ясности:

1. Убедитесь, что подмодуль зарегистрирован и отправлен на свой сервер. Вам также необходимо знать, на какой ветке он находится.
2. Вам нужен URL-адрес вашего подмодуля! Используйте more .gitmodules, потому что после удаления подмодуля его больше не будет.
3. Теперь вы можете использовать deinit, rm, а затем submodule add

ПРИМЕР

• Подмодуль Git находится в: Classes / lib / mustIReally
• Переход к: lib / AudioBus
• URL: http://developer.audiob.us/download/SDK.git

КОМАНДЫ

    git submodule deinit Classes/lib/mustIReally
    git rm foo
    git submodule add http://developer.audiob.us/download/SDK.git lib/AudioBus

    # do your normal commit and push
    git commit -a 

ПРИМЕЧАНИЕ. git mv этого не делает. Вообще.