Wie verschiebe ich ein vorhandenes Git-Submodul in ein Git-Repository?

Ich möchte den Verzeichnisnamen eines Git-Submoduls in meinem Git-Superprojekt ändern.

Nehmen wir an, ich habe den folgenden Eintrag in meiner .gitmodulesDatei:

[submodule ".emacs.d/vimpulse"]  
path = .emacs.d/vimpulse  
url = git://gitorious.org/vimpulse/vimpulse.git

Was muss ich eingeben, um das .emacs.d/vimpulseVerzeichnis zu verschieben, .emacs.d/vendor/vimpulseohne es zuerst zu löschen ( hier und hier erklärt ) und dann erneut hinzuzufügen.

Braucht Git wirklich den gesamten Pfad im Submodul-Tag?

[submodule ".emacs.d/vimpulse"]

oder ist es auch möglich, nur den Namen des Teilprojekts zu speichern?

[submodule "vimpulse"]

Hinweis: Wie in den Kommentaren erwähnt, bezieht sich diese Antwort auf die Schritte, die bei älteren Versionen von git erforderlich sind. Git bietet jetzt native Unterstützung für das Verschieben von Submodulen:

Seit Git 1.8.5 git mv old/submod new/submodfunktioniert es wie erwartet und erledigt die gesamte Installation für Sie. Möglicherweise möchten Sie Git 1.9.3 oder höher verwenden, da es Korrekturen für das Verschieben von Submodulen enthält.

Der Vorgang ähnelt dem Entfernen eines Submoduls (siehe Wie entferne ich ein Submodul? ):

1. Bearbeiten .gitmodulesund ändern Sie den Pfad des Submoduls entsprechend und fügen Sie ihn in den Index mit ein git add .gitmodules.
2. Erstellen Sie bei Bedarf das übergeordnete Verzeichnis des neuen Speicherorts des Submoduls ( mkdir -p new/parent).
3. Verschieben Sie den gesamten Inhalt vom alten in das neue Verzeichnis ( mv -vi old/parent/submodule new/parent/submodule).
4. Stellen Sie sicher, dass Git dieses Verzeichnis verfolgt ( git add new/parent).
5. Entfernen Sie das alte Verzeichnis mit git rm --cached old/parent/submodule.
6. Verschieben Sie das Verzeichnis .git/modules/old/parent/submodulemit seinem gesamten Inhalt nach .git/modules/new/parent/submodule.
7. Bearbeiten Sie die .git/modules/new/parent/configDatei, und stellen Sie sicher, dass das Arbeitsbaumelement auf die neuen Speicherorte verweist. In diesem Beispiel sollte dies der Fall sein worktree = ../../../../../new/parent/module. Normalerweise sollten sich ..an dieser Stelle zwei weitere Verzeichnisse im direkten Pfad befinden.

8. Bearbeiten Sie die Datei new/parent/module/.git, und stellen Sie sicher, dass der Pfad darin auf den richtigen neuen Speicherort im Hauptprojektordner verweist. .gitIn diesem Beispiel also gitdir: ../../../.git/modules/new/parent/submodule.

   git status Die Ausgabe sieht für mich danach so aus:

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

9. Übernehmen Sie abschließend die Änderungen.

Die modernste Antwort aus Vallorics Kommentar oben:

1. Upgrade auf Git 1.9.3 (oder 2.18, wenn das Submodul verschachtelte Submodule enthält )
2. git mv old/submod new/submod
3. Danach werden die .gitmodules und das Submodule-Verzeichnis bereits für ein Commit bereitgestellt (Sie können dies mit überprüfen git status.)
4. Übernehmen Sie die Änderungen mit git commitund Sie können loslegen!

Erledigt!

In meinem Fall wollte ich ein Submodul aus einem Verzeichnis in ein Unterverzeichnis verschieben, z. B. "AFNetworking" -> "ext / AFNetworking". Dies sind die Schritte, die ich befolgt habe:

1. Bearbeiten Sie .gitmodules, indem Sie den Namen und den Pfad des Submoduls in "ext / AFNetworking" ändern.
2. Verschieben Sie das Git-Verzeichnis des Submoduls von ".git / modules / AFNetworking" nach ".git / modules / ext / AFNetworking".
3. Verschieben Sie die Bibliothek von "AFNetworking" nach "ext / AFNetworking".
4. Bearbeiten Sie ".git / modules / ext / AFNetworking / config" und korrigieren Sie die [core] worktreeZeile. Meins änderte sich von ../../../AFNetworkingzu../../../../ext/AFNetworking
5. Bearbeiten Sie "ext / AFNetworking / .git" und korrigieren Sie gitdir. Meins änderte sich von ../.git/modules/AFNetworkingzu../../git/modules/ext/AFNetworking
6. git add .gitmodules
7. git rm --cached AFNetworking
8. git submodule add -f <url> ext/AFNetworking

Schließlich sah ich im Git-Status:

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

Et voila. Das obige Beispiel ändert nicht die Verzeichnistiefe, was einen großen Unterschied zur Komplexität der Aufgabe macht, und ändert auch nicht den Namen des Submoduls (was möglicherweise nicht wirklich notwendig ist, aber ich habe es getan, um mit dem übereinzustimmen würde passieren, wenn ich ein neues Modul an diesem Pfad hinzufügen würde.)

[Update: 26.11.2014] Wie Yar unten ausführlich zusammenfasst , stellen Sie sicher, dass Sie die URL des Submoduls kennen , bevor Sie etwas unternehmen. Wenn unbekannt, öffnen .git/.gitmodulesund untersuchen Sie den Schlüssel submodule.<name>.url.

Was für mich funktionierte, war das Entfernen des alten Submoduls mit git submodule deinit <submodule>gefolgt von git rm <submodule-folder>. Fügen Sie dann das Submodul erneut mit dem neuen Ordnernamen hinzu und schreiben Sie fest. Wenn Sie den Git-Status vor dem Festschreiben überprüfen, wird das alte Submodul in den neuen Namen umbenannt und das Git-Modul geändert.

$ 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"

Der Trick scheint zu verstehen, dass das .gitVerzeichnis für Submodule jetzt im Master-Repository unter gespeichert .git/modulesist und jedes Submodul eine .gitDatei hat, die darauf verweist. Dies ist das Verfahren, das Sie jetzt benötigen:

• Bewegen Sie das Submodul in sein neues Zuhause.
• Bearbeiten Sie die .gitDatei im Arbeitsverzeichnis des Submoduls und ändern Sie den darin enthaltenen Pfad so, dass er auf das richtige Verzeichnis im Verzeichnis des Master-Repositorys verweist .git/modules.
• Geben Sie das .git/modulesVerzeichnis des Master-Repositorys ein und suchen Sie das Verzeichnis, das Ihrem Submodul entspricht.
• Bearbeiten Sie die configDatei und aktualisieren Sie den worktreePfad so, dass er auf den neuen Speicherort des Arbeitsverzeichnisses des Submoduls verweist.
• Bearbeiten Sie die .gitmodulesDatei im Stammverzeichnis des Master-Repositorys und aktualisieren Sie den Pfad zum Arbeitsverzeichnis des Submoduls.
• git add -u
• git add <parent-of-new-submodule-directory>(Es ist wichtig, dass Sie das übergeordnete Verzeichnis und nicht das Submodulverzeichnis selbst hinzufügen .)

Ein paar Anmerkungen:

• Die [submodule "submodule-name"]Zeilen in .gitmodulesund .git/configmüssen übereinstimmen, müssen aber nichts anderem entsprechen.
• Das Submodul-Arbeitsverzeichnis und das .gitVerzeichnis müssen korrekt aufeinander verweisen.
• Das .gitmodulesund.git/config Dateien sollten synchronisiert werden.

Die Zeichenfolge in Anführungszeichen nach "[Submodul" spielt keine Rolle. Sie können es in "foobar" ändern, wenn Sie möchten. Es wird verwendet, um den passenden Eintrag in ".git / config" zu finden.

Wenn Sie die Änderung vornehmen, bevor Sie "git submodule init" ausführen, funktioniert dies daher einwandfrei. Wenn Sie die Änderung vornehmen (oder die Änderung durch Zusammenführen übernehmen), müssen Sie entweder .git / config manuell bearbeiten oder "git submodule init" erneut ausführen. Wenn Sie Letzteres tun, bleibt ein harmloser "gestrandeter" Eintrag mit dem alten Namen in .git / config übrig.

Sie können einfach ein neues Submodul hinzufügen und das alte Submodul mit Standardbefehlen entfernen. (sollte versehentliche Fehler in .git verhindern)

Beispieleinrichtung:

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>

Beispiel: Verschieben Sie 'jquery' nach '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}"

Bonusmethode für große Submodule:

Wenn das Submodul groß ist und Sie nicht auf den Klon warten möchten, können Sie das neue Submodul mit dem alten als Ursprung erstellen und dann den Ursprung wechseln.

Beispiel (verwenden Sie das gleiche Beispielsetup)

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
...

Die angegebene Lösung hat bei mir nicht funktioniert, eine ähnliche Version jedoch ...

Dies ist bei einem geklonten Repository der Fall, daher sind die Git-Repos des Submoduls in den Top-Repositorys .git dir enthalten. Alle Kationen stammen aus dem obersten Repository:

1. Bearbeiten Sie .gitmodules und ändern Sie die Einstellung "path =" für das betreffende Submodul. (Sie müssen weder die Bezeichnung ändern noch diese Datei zum Index hinzufügen.)

2. Bearbeiten Sie .git / modules / name / config und ändern Sie die Einstellung "worktree =" für das betreffende Submodul

3. Lauf:

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

Ich frage mich, ob es einen Unterschied macht, ob die Repositorys atomare oder relative Submodule sind, in meinem Fall war es relativ (Submodul / .git ist ein Verweis zurück auf topproject / .git / modules / submodule).

Verwenden Sie einfach das Shell-Skript git-submodule-move .

Ich habe gestern gerade diese Tortur durchgemacht und diese Antwort hat perfekt funktioniert. Hier sind meine Schritte zur Klarheit:

1. Stellen Sie sicher, dass das Submodul eingecheckt und auf seinen Server übertragen wird. Sie müssen auch wissen, auf welchem ​​Zweig es ist.
2. Sie benötigen die URL Ihres Submoduls! Verwenden more .gitmodulesSie diese Option, da das Submodul nach dem Löschen nicht mehr vorhanden sein wird
3. Jetzt können Sie verwenden deinit, rmund dannsubmodule add

BEISPIEL

• Das Git-Submodul befindet sich in: Classes / lib / mustIReally
• Umzug nach: lib / AudioBus
• URL: http://developer.audiob.us/download/SDK.git

BEFEHLE

    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 

HINWEIS: git mv macht das nicht. Überhaupt.