Einführung in EGit

1. Überblick

In diesem Artikel werden wir EGit erkunden - eine Weiterentwicklung der JGit-Bibliothek für Eclipse.

2. EGit Setup

Während des Artikels verwenden wir die folgenden Tools:

  • Eclipse Neon.3 Version 4.6.3

  • EGit-Plugin-Version 4.8

2.1. EGit in Eclipse installieren

Beginnend mit Eclipse Juno ist EGit in der Eclipse selbst enthalten.

Bei älteren Versionen von Eclipse können Sie das Plugin über Help → Install New Software installieren und die URL http://download.eclipse.org/egit/updates angeben:

2.2. Einen Commiter identifizieren

Git muss den Benutzer hinter einem Commit verfolgen, daher sollten wir unsere Identität angeben, wenn wir Commit über EGit machen.

Dies geschieht über Preferences → Team → Git → Configuration und durch Klicken auf Add Entry , um Informationen für user.name und user.email aufzunehmen:

3. Repositories

3.1. Repositories anzeigen

EGit enthält die Repositories-Ansicht, mit der wir:

  • Durchsuchen Sie unser lokales Repository

  • Lokale Repositorys hinzufügen und initialisieren

  • Repositorys entfernen

  • Klonen Sie Remote-Repositories

  • Check out Projekte

  • Zweige verwalten

Klicken Sie zum Öffnen der Repositories-Ansicht auf Window → Show View → Other → Git → Git Repositories:

3.2. Neues Repository erstellen

Wir müssen ein Projekt erstellen und mit der rechten Maustaste darauf klicken, um _Team → Projekt teilen , und Create._ auszuwählen

Hier wählen wir das Repository-Verzeichnis aus und klicken auf Finish:

3.3. Repository klonen

Wir können ein Repository von einem Remote-Git-Server auf unser lokales Dateisystem klonen.

Gehen wir zu Datei → Importieren …​ → Git → Projekte von Git → Weiter → Klon-URI → Weiter, , das folgende Fenster wird angezeigt:

Wir können dasselbe Fenster auch über die Symbolleistenschaltfläche Clone Remote Repository auf der Registerkarte Repositories__View öffnen.

Git unterstützt mehrere Protokolle wie https, ssh, git usw. Wenn Sie die URI des Remote-Repositorys einfügen, werden andere Einträge automatisch gefüllt.

4. Geäst

Es gibt zwei Arten von Zweigen, mit denen wir uns befassen:

  • Lokale Niederlassung

  • Fernverfolgungszweig

4.1. Lokale Niederlassung erstellen

Wir können einen neuen lokalen Zweig erstellen, indem Sie auf Team → Repository → Wechseln zu → Neuer Zweig klicken:

Wir können den Remote-Tracking-Zweig auswählen, von dem aus unsere lokale Zweigstelle basiert. Durch Hinzufügen einer Upstream-Konfiguration zu unseren neuen lokalen Zweigstellen wird die Synchronisierung der lokalen Änderungen mit den entfernten Änderungen vereinfacht.

Es wird empfohlen, die Option im Dialogfeld "Upstream konfigurieren" für Push und Pull zu aktivieren.

Eine weitere Methode zum Öffnen des neuen Verzweigungsdialogs durch Klicken mit der rechten Maustaste auf Zweige in der Ansicht __Repositories → Wechseln zu → Neuer Zweig

4.2. Auschecken der Filiale

Klicken Sie in der Ansicht Repositories mit der rechten Maustaste auf den Zweignamen und klicken Sie auf Check Out :

Oder klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie Team → Wechseln zu → und wählen Sie den Zweignamen aus:

5. Verfolgen von Dateien mit Git

5.1. Änderungen verfolgen

Fragezeichen erscheinen in Dateien, die noch nicht von Git kontrolliert werden. Wir können diese neuen Dateien verfolgen, indem Sie mit der rechten Maustaste darauf klicken und Team → Zu Index hinzufügen auswählen.

Von hier sollte der Dekorateur in __ () - Zeichen wechseln.

5.2. Änderungen übernehmen

Wir möchten Änderungen an verfolgten Dateien vornehmen. Klicken Sie mit der rechten Maustaste auf diese Dateien und wählen Sie Team → Commit: .

Standardmäßig werden Autor und Committer aus der Datei .gitconfig in unserem Home-Verzeichnis übernommen.

Wir können eine Commit-Nachricht eingeben, um die Änderungen zu erläutern. Durch Klicken auf das Symbol Add-Signed-off-by in der oberen rechten Ecke können Sie ein Signed-Off-By -Tag hinzufügen.

5.3. Inspektionsgeschichte

Wir können den Verlauf einer Datei überprüfen, indem Sie mit der rechten Maustaste darauf klicken und __Team → In Verlauf anzeigen auswählen.

Ein Verlaufsdialog zeigt alle festgeschriebenen Änderungen der geprüften Datei:

Wir können die letzten Änderungen in der Vergleichsansicht öffnen, indem Sie auf das Symbol für den Vergleichsmodus in der oberen rechten Ecke der Registerkarte "Verlauf" klicken und dann auf den Dateinamen doppelklicken (hier ein Beispiel:

HelloEgit/src/HelloEgitClass.java ) in Dateiliste:

5.4. Änderungen an das Remote-Repository weiterleiten

Um unsere Änderungen voranzutreiben, benötigen wir ein Remote-Git-Repository.

Über Team → Remote → Push können Sie die https-URL des neuen Git-Remote-Repository in einem Assistenten eingeben:

Nächste Schritte sind:

  • Wählen Sie die Option Add All Branches Spec , um dem Zweig lokale Zweignamen zuzuordnen

gleiche Zweignamen im Ziel-Repository ** Drücken Sie die Bestätigungstaste - der Assistent zeigt eine Vorschau von

geänderte Dateien ** Zum Schluss klicken wir auf Finish , um unser Repository zur Remote zu verschieben

Standort.

Wenn wir die Upstream-Konfiguration aus Abschnitt 4.1 eingerichtet haben, wird dieser Konfigurationsdialog nicht angezeigt und der Push wird wesentlich einfacher.

5.5. Abholung von Upstream

Wenn wir mit einem lokalen Zweig arbeiten, der auf einem Remote-Tracking-Zweig basiert, können wir jetzt Änderungen vom Upstream abrufen.

Um vom Upstream abzurufen, klicken Sie mit der rechten Maustaste auf das Project und wählen Sie Team → Fetch from Upstream (oder klicken Sie mit der rechten Maustaste auf das Repository in der Repositories View und wählen Sie Fetch from Upstream ).

Dieser Abruf kann konfiguriert werden, indem Sie mit der rechten Maustaste auf das Projekt klicken und Team → Remote → Abruf aus Upstream konfigurieren auswählen:

** 5.6. Vergleich

Wenn Sie die Änderungen zwischen dem lokalen Arbeitsverzeichnis und einer festgeschriebenen Änderung sehen möchten, können Sie mit der rechten Maustaste auf die Ressource klicken und Compare With wählen. Dies öffnet die Synchronize-Ansicht , damit wir die Änderungen durchsuchen können:

Durch Doppelklick auf die geänderte Datei wird der Vergleichseditor geöffnet, so dass wir die Änderungen vergleichen können.

Wenn wir zwei Commits vergleichen möchten, müssen Sie __Team → In Historie anzeigen auswählen.

In der Verlaufsansicht werden die beiden zu vergleichenden Commits hervorgehoben und die Option Compare with Each Other ausgewählt:

Wenn wir das Arbeitsverzeichnis mit einem Zweig vergleichen möchten, können Sie Team → Synchronize verwenden.

5.7. Zusammenführen

Beim Zusammenführen werden Änderungen von einem Zweig oder Tag in den aktuell ausgecheckten Zweig übernommen.

Wir können zusammenführen, indem Sie auf Team → Merge klicken oder mit der rechten Maustaste auf den Repository-Namen in der Repository-Ansicht klicken und Merge auswählen:

Jetzt können wir den Zweig oder das Tag auswählen, das mit dem momentan ausgecheckten Zweig zusammengeführt werden soll.

6. Fazit

In diesem Tutorial haben wir das EGit-Plugin für Eclipse vorgestellt, wie es installiert und konfiguriert wird und wie es in unserer täglichen Entwicklung verwendet wird.

Weitere Informationen zu EGit finden Sie in der offiziellen Dokumentation http://wiki.eclipse.org/EGit/User__Guide