Dateien in Git hinzufügen und entfernen

Abgeschlossen

Nachdem Sie Ihr lokales Git-Repository initialisiert haben, können Sie mit der Arbeit an Ihrer AL-Erweiterung beginnen. Jede von Ihnen erstellte Datei muss Ihrem Repository hinzugefügt werden. Dazu müssen Sie einige Befehle ausführen. Schauen wir uns verschiedene Befehle an, die Sie Ihrem Repository hinzufügen oder daraus entfernen bzw. mit denen Sie Ihre Änderungen in das Git-Verzeichnis übertragen können.

Dateien hinzufügen

Um Git eine nicht verfolgte oder geänderte Datei (oder mehrere Dateien) hinzuzufügen, können Sie den Befehl Hinzufügen verwenden. Dadurch werden Ihre geänderten Dateien aus dem Arbeitsverzeichnis zum Staging-Bereich hinzugefügt. Mit dem Befehl Hinzufügen geben Sie den Dateinamen der hinzuzufügenden Datei an. Ein Sternchen kann verwendet werden, um alle Dateien anzuzeigen.

git add <filename>

git add *

Innerhalb von Visual Studio Code können Sie eine Datei hinzufügen, indem Sie auf das Zeichen + neben einem Dateinamen im Quellcodeverwaltungsfenster (STRG+UMSCHALT+G) klicken. Durch diese Aktion wird Ihre Datei in den Staging-Bereich verschoben. Um alle geänderten Dateien hinzuzufügen, klicken Sie auf das Zeichen + im Bereich Änderungen.

Screenshot der Funktion + zum Hinzufügen einer Datei im Staging-Bereich

Das Ergebnis des Hinzufügens von Dateien zum Staging-Bereich wird im Bereich Bereitgestellte Änderungen innerhalb von Visual Studio Code angezeigt. Im nächsten Screenshot werden die Dateien app.json, BodyType.al und .gitignore bereitgestellt. Ihnen wird auch der Statuscode A zugewiesen. Dies weist darauf hin, dass sie hinzugefügt wurden.

Screenshot des Abschnitts „Bereitgestellte Änderungen“ in Visual Studio Code

Eine bereitgestellte Datei entfernen

Wenn Sie dem Staging-Bereich eine Datei hinzugefügt haben, sie jedoch nicht eingefügt werden sollte, können Sie die Bereitstellung dieser Datei aufheben. Um die Bereitstellung einer Datei aufzuheben, müssen Sie den Befehl Zurücksetzen verwenden.

git reset HEAD <filename>

Dadurch wird die Datei wieder in das Arbeitsverzeichnis verschoben und aus dem Staging-Bereich entfernt. Wenn Sie dies für kürzlich hinzugefügte Dateien durchführen, wird Ihre Datei nicht mehr verfolgt.

In Visual Studio Code können Sie das Symbol - oder den Befehl Zurücksetzen zum Aufheben der Bereitstellung verwenden.

Screenshot der Funktion ‑ zum Aufheben oder Zurücksetzen der bereitgestellten Datei

Ihre bereitgestellten Dateien in das Git-Verzeichnis übertragen

Sobald sich Ihre Dateien im Staging-Bereich befinden, können Sie den Befehl Commit verwenden, um sie in das Git-Verzeichnis zu übertragen. Bei jedem Commit werden alle Dateien aus dem Staging-Bereich übernommen, zum Git-Verzeichnis hinzugefügt und Ihr Benutzername und Ihre E-Mail-Adresse werden im Commit aufgenommen.

git commit

Ein Commit benötigt immer eine Commit-Nachricht. Wenn Sie den vorherigen Befehl verwenden, wird der Standardeditor geöffnet, und Sie können eine Commit-Nachricht eingeben. Sie können auch die Option -m verwenden.

git commit -m "Your message comes here"

In Visual Studio Code gibt es eine GUI, um Ihre Commit-Nachricht eingeben zu können. Es gibt zwei Orte, an denen Sie diese Nachricht eingeben können. Sie können sie im SCM-Bereich direkt über dem Abschnitt Bereitgestellte Änderungen eingeben.

Screenshot des Bereichs „Eine Commit-Nachricht hinzufügen“ im SCM-Bereich

Wenn Sie beim Klicken auf die Schaltfläche „Commit“ keine Nachricht angeben, fordert Sie Visual Studio Code außerdem auf, eine Nachricht einzugeben.

Screenshot der Eingabeaufforderung zum Bereitstellen einer Nachricht

Der eigentliche Commit erfolgt über das Symbol Überprüfen oder die Befehle Commit aus der Git-Befehlsliste. Sie können die Befehlsliste öffnen, indem Sie auf die drei Punkte klicken.

Bei Änderungen mit Gestaffelter Commit werden nur Dateien im Staging-Bereich bestätigt. Das Häkchensymbol ist eine Verknüpfung für den Befehl Gestaffelter Commit. Normalerweise erstellt jeder Commit einen neuen Commit-Eintrag in Git. Jeder Commit generiert eine eindeutige Commit-Zeichenfolge, die diesen Commit eindeutig identifiziert.

Beispiel:

521747298a3790fde1710f3aa2d03b55020575aa

Wenn Sie die Option Ändern auswählen, werden Ihre Änderungen zum letzten Commit hinzugefügt, anstatt einen neuen Commit zu erstellen. Dies ist nützlich, wenn Sie einige Dateien vergessen haben.

git commit --amend

Screenshot zu „Änderungen in Visual Studio Code übertragen“

Wenn dem Staging-Bereich keine Dateien hinzugefügt werden, Sie jedoch auf die Schaltfläche „Commit“ klicken, zeigt Visual Studio Code eine Meldung an, dass sich keine Dateien im Staging-Bereich befinden. Sie werden jedoch auch gefragt, ob Sie stattdessen die Dateien in Ihr Arbeitsverzeichnis übertragen möchten. Dadurch wird der Staging-Bereich umgangen. Sie können dies auch tun, indem Sie die Option „-a“ im Befehl „commit“ verwenden.

git commit -a -m "Your message comes here"

Sobald ein Commit ausgeführt wurde, klicken Sie auf den Verzweigungsnamen (in diesem Beispiel „Übergeordnet“). Daraufhin wird eine Option zum Erstellen einer neuen Verzweigung angezeigt. Außerdem wird die Commit-ID angezeigt, die Ihre Verzweigung verwendet.

Screenshot der Commit-ID im Verzweigungsnamen

Es wird empfohlen, Ihre geänderten Dateien häufig dem Staging-Bereich hinzuzufügen. Wenn sie bereit und stabil sind, können Sie sie in Ihr Git-Verzeichnis übertragen. Warten Sie nicht bis zum Ende des Tages, sondern übernehmen Sie Ihre Änderungen so oft wie möglich.

Eine Datei aus dem Repository entfernen

Wenn Sie eine Datei mit Windows Explorer oder innerhalb Ihres Arbeitsverzeichnisses oder in Visual Studio Code löschen, ist Ihre Datei weiterhin Bestandteil des Git-Repositorys. Verwenden Sie den Befehl rm, um das Git-Repository anzugeben, mit dem Sie die Datei aus Ihrem Projekt löschen möchten. Diese Aktion wird zusammen mit den von Ihnen geänderten oder hinzugefügten Dateien in Ihrem Staging-Bereich gespeichert. Wenn Sie ein Commit durchführen, wird das Entfernen Ihrer Datei im Git-Repository abgeschlossen.

git rm <filename>

Ein Löschvorgang wird automatisch im Arbeitsverzeichnis erkannt und in Visual Studio Code sichtbar gemacht. Diese Datei erhält den Statuscode D. Dies zeigt an, dass diese Datei von der Festplatte gelöscht wurde. Stellen Sie diese Änderung bereit, um den Befehl rm und ein Commit auszuführen und so die Datei aus dem Git-Verzeichnis zu entfernen.

Screenshot einer mit D markierten Datei im Arbeitsverzeichnis

Vielleicht möchten Sie Ihre Datei nicht von der Festplatte löschen, aber Sie möchten sie aus Git entfernen. Sie können hierzu rm ‑-cached verwenden.

git rm --cached <filename>

Mit dieser Aktion wird Ihre Datei aus dem Staging-Bereich entfernt, und es wird ein Löschvorgang im Git-Repository durchgeführt, aber Ihre Datei befindet sich weiterhin auf Ihrer Festplatte. Die Datei wird nicht mehr verfolgt.

Ihre Änderungen rückgängig machen

Wenn Sie einige Änderungen an einer Datei vorgenommen haben und die vorherige Version wiederherstellen möchten, können Sie den Befehl Auschecken verwenden. Dadurch wird die übertragene Version aus dem Git-Verzeichnis abgerufen und in Ihr Arbeitsverzeichnis verschoben.

git checkout <filename>