Wie ignoriere ich Dateien in Subversion?

(Diese Antwort wurde aktualisiert, um dem Verhalten von SVN 1.8 und 1.9 zu entsprechen.)

Du hast 2 Fragen:

Dateien als ignoriert markieren:

Mit "ignorierte Datei" meine ich, dass die Datei nicht als "unversioned" in Listen angezeigt wird: Ihr SVN-Client gibt vor, dass die Datei im Dateisystem überhaupt nicht vorhanden ist.

Ignorierte Dateien werden durch ein "Dateimuster" angegeben. Die Syntax und das Format von Dateimustern wird in der Online-Dokumentation von SVN erläutert: http://svnbook.red-bean.com/nightly/de/svn.advanced.props.special.ignore.html "Dateimuster in Subversion ".

Subversion ab Version 1.8 (Juni 2013) und höher unterstützt drei verschiedene Arten, Dateimuster anzugeben. Hier eine Zusammenfassung mit Beispielen:

1 - Laufzeitkonfigurationsbereich - Option global-ignores:

• Dies ist nur eine Einstellung für clientseitig, sodass Ihre global-ignores-Liste nicht von anderen Benutzern freigegeben wird. Sie gilt für alle Repos, die Sie auf Ihrem Computer ausgecheckt haben.
• Diese Einstellung ist in Ihrer Runtime-Konfigurationsbereichsdatei definiert:
  • Windows (dateibasiert) - C:\Users\{you}\AppData\Roaming\Subversion\config
  • Windows (registrierungsbasiert) - Software\Tigris.org\Subversion\Config\Miscellany\global-ignores in HKLM und HKCU.
  • Linux/Unix - ~/.Subversion/config

2 - Die svn:ignore-Eigenschaft, die für Verzeichnisse (nicht für Dateien) festgelegt ist:

• Diese wird im Repo gespeichert, so dass andere Benutzer die gleichen Ignorier-Dateien haben. Ähnlich wie .gitignore.
• svn:ignore wird auf Verzeichnisse angewendet und ist nicht rekursiv oder vererbt. Alle Dateien oder unmittelbar -Unterverzeichnisse des übergeordneten Verzeichnisses, die dem Dateimuster entsprechen, werden ausgeschlossen.

• Während SVN 1.8 das Konzept der "geerbten Eigenschaften" hinzufügt, wird die svn:ignore-Eigenschaft selbst in nicht unmittelbar nachkommenden Verzeichnissen ignoriert:

  cd ~/myRepoRoot                             # Open an existing repo.
  echo "foo" > "ignoreThis.txt"                # Create a file called "ignoreThis.txt".
  
  svn status                                  # Check to see if the file is ignored or not.
  > ?    ./ignoreThis.txt
  > 1 unversioned file                        # ...it is NOT currently ignored.
  
  svn propset svn:ignore "ignoreThis.txt" .   # Apply the svn:ignore property to the "myRepoRoot" directory.
  svn status
  > 0 unversioned files                       # ...but now the file is ignored!
  
  cd subdirectory                             # now open a subdirectory.
  echo "foo" > "ignoreThis.txt"                # create another file named "ignoreThis.txt".
  
  svn status
  > ?    ./subdirectory/ignoreThis.txt        # ...and is is NOT ignored!
  > 1 unversioned file
  

  (Die Datei ./subdirectory/ignoreThis wird also nicht ignoriert, obwohl "ignoreThis.txt" auf den . Repo-Stamm angewendet wird).

• Um eine Ignorierliste rekursiv anzuwenden, müssen Sie svn propset svn:ignore <filePattern> . --recursive verwenden.

  • Dadurch wird eine Kopie der Eigenschaft in jedem Unterverzeichnis erstellt.
  • Wenn der <filePattern>-Wert in einem untergeordneten Verzeichnis unterschiedlich ist, überschreibt der untergeordnete Wert die übergeordneten Elemente vollständig, so dass es keinen "additiven" Effekt gibt.
  • Wenn Sie also <filePattern> im Stammverzeichnis . ändern, müssen Sie ihn mit --recursive ändern, um ihn in den untergeordneten und untergeordneten Verzeichnissen zu überschreiben.

• Ich stelle fest, dass die Befehlszeilensyntax gegenintuitiv ist.

  • Ich ging davon aus, dass Sie eine Datei in SVN ignorieren würden, indem Sie etwas wie svn ignore pathToFileToIgnore.txt eingeben. Dies funktioniert jedoch nicht so, wie die Ignor-Funktion von SVN funktioniert.

3- Die svn:global-ignores-Eigenschaft. Benötigt SVN 1.8 (Juni 2013):

• Dies ist ähnlich zu svn:ignore, außer dass die Funktion "geerbte Eigenschaften" von SVN 1.8 verwendet wird.
• Im Vergleich zu svn:ignore wird das Dateimuster automatisch in jedes untergeordnete Verzeichnis angewendet (nicht nur für untergeordnete Objekte) .
  • Dies bedeutet, dass es nicht erforderlich ist, svn:global-ignores mit dem Flag --recursive festzulegen, da vererbte Muster für Ignorierungsdateien automatisch übernommen werden, wenn sie vererbt werden.

• Führen Sie denselben Befehlssatz wie im vorherigen Beispiel aus, verwenden Sie stattdessen jedoch svn:global-ignores:

  cd ~/myRepoRoot                                    # Open an existing repo
  echo "foo" > "ignoreThis.txt"                       # Create a file called "ignoreThis.txt"
  svn status                                         # Check to see if the file is ignored or not
  > ?    ./ignoreThis.txt
  > 1 unversioned file                               # ...it is NOT currently ignored
  
  svn propset svn:global-ignores "ignoreThis.txt" .
  svn status
  > 0 unversioned files                              # ...but now the file is ignored!
  
  cd subdirectory                                    # now open a subdirectory
  echo "foo" > "ignoreThis.txt"                       # create another file named "ignoreThis.txt"
  svn status
  > 0 unversioned files                              # the file is ignored here too!
  

Für TortoiseSVN-Benutzer:

Diese ganze Anordnung war für mich verwirrend, da TortoiseSVNs Terminologie (wie sie in ihrem Windows Explorer-Menüsystem verwendet wird) anfangs für mich irreführend war - ich war nicht sicher, welche Bedeutung die Menüs "Rekursiv hinzufügen", "Hinzufügen *" und "Hinzufügen" des Ignore-Menüs haben. Optionen. Ich hoffe, in diesem Beitrag wird erläutert, wie die Funktion Ignorieren in die Funktion SVN-Eigenschaften eingebunden wird. Das heißt, ich empfehle die Verwendung der Befehlszeile, um ignorierte Dateien festzulegen, so dass Sie ein Gefühl für die Funktionsweise erhalten, anstatt die GUI zu verwenden, und nur die GUI zum Bearbeiten von Eigenschaften verwenden, nachdem Sie mit der Befehlszeile vertraut sind.

Auflisten von Dateien, die ignoriert werden:

Mit dem Befehl svn status werden ignorierte Dateien ausgeblendet (dh Dateien, die einem RGA global-ignores-Muster entsprechen oder einem unmittelbaren svn:ignore-Muster des übergeordneten Verzeichnisses oder einem beliebigen svn:global-ignores-Muster eines Ancesor-Verzeichnisses entsprechen.

Verwenden Sie die Option --no-ignore, um diese Dateien anzuzeigen. Ignorierte Dateien haben den Status I, dann die Ausgabe an grep weiterleiten, um nur Zeilen anzuzeigen, die mit "I" beginnen.

Der Befehl lautet:

svn status --no-ignore | grep "^I"

Zum Beispiel:

svn status
> ? foo                             # An unversioned file
> M modifiedFile.txt                # A versioned file that has been modified

svn status --no-ignore
> ? foo                             # An unversioned file
> I ignoreThis.txt                  # A file matching an svn:ignore pattern
> M modifiedFile.txt                # A versioned file that has been modified

svn status --no-ignore | grep "^I"
> I ignoreThis.txt                  # A file matching an svn:ignore pattern

ta-da!