Hochschule Mannheim University of Applied Sciences

1423841 - Laura Most – 7IMB

1423841@stud.hs-mannheim.de

Praktische Einführung in die

Versionsverwaltung mit Eclipse

Version Control Systems (VCS)

1423841 - Larua Most - 7IMB 2

Vorteile:

• Änderungen werden als Version gespeichert

• Alte Versionen können wiederhergestellt werden

• Vergleiche zwischen den Versionen ist möglich

• Zusammenarbeit mehrere Entwickler ist einfach

• Nachvollziehbar welche Änderungen von welchem Entwickler

wann erstellt wurden

17.10.2017

Voraussetzungen

1423841 - Larua Most - 7IMB 3

• Eclipse und EGit sind installiert

• Ein erstes JavaProject wurde erstellt

• Ein Github-Account: https://github.com/

• “GitHub is a code hosting platform for version control and collaboration.” 1

• Ein angelegtes Github Repository

1 Quelle: https://guides.github.com/activities/hello-world/

17.10.2017

EGit

1423841 - Larua Most - 7IMB 4 17.10.2017

• Plugin zur Git Integration für die Eclipse IDE

• Konfiguration eures Github-Kontos:

• Window -> Preferences

• Preferences -> Team -> Git -> Configuration

• Email und Username: Entsprechend eurem Github-Account

Lokales Repository erstellen

1423841 - Larua Most - 7IMB 5 17.10.2017

• Um eure Dateien lokal der Versionsverwaltung zu unterstellen,

müsst ihr euer Projekt als Git Repository konfigurieren.

• Rechts-Klick auf euer Projekt: Team -> Share Project

• Klick auf Create -> neue Dialogbox öffnet sich

• Auswählen wo das Repository angelegt werden soll

• Bestätigen und mit Finish Abschließen

Lokales Repository erstellen

1423841 - Larua Most - 7IMB 6 17.10.2017

• Jetzt sollte bei eurem JavaProject kleine Fragezeichen stehen, d.h.

dass die Dateien dem Git Repository nicht bekannt sind.

• Um das zu ändern: Rechts-Klick auf JavaProject -> Team -> Add to Index

• Icons ändern sich, bei der .java-Datei sollte ein kleines grünes Plus

stehen, d.h. die Datei wurden dem Git Repository hinzugefügt

• Die Dateien werden aber erst nach dem Commit verfolgt

Commiten

1423841 - Larua Most - 7IMB 7 17.10.2017

• Um Änderungen zu speichern, müssen die Files committed werden.

Das Projekt kann auf jede committede Änderung zurückgesetzt

werden.

• Rechts-Klick auf das Projekt -> Team -> Commit

• Die StagingView wird geöffnet

• Hier könnt ihr nochmal überprüfen, welche Dateien ihr dem Commit

hinzugefügt habt (Staged Files) und die Dateien auch nochmal entfernen

(Rechts-Click auf die Datei -> Remove from Index)

• Commit Message sollte beschreiben, welche Änderungen an den Files

vorgenommen wurden

• Dann auf Commit klicken um den Commit abzuschließen

Commiten

1423841 - Larua Most - 7IMB 8 17.10.2017

• Icons des JavaProjects haben sich in kleine gelbe Tonnen

verwandelt, d.h. es handelt sich um Dateien, die dem Repository

bekannte sind und die verfolgt werden.

Projekt auf Github pushen

1423841 - Larua Most - 7IMB 9 17.10.2017

• Um ein Projekt für andere verfügbar zu machen, muss es als

externes/remote Repository angelegt werden. Wir nutzen hierfür

Github.

• Auf Github zum Repository gehen, unter Quick Setup die URI

kopieren

• Eclipse: Rechts-Klick auf das Projekt: Team -> Remote -> Push

• Dialogfeld Push to another repository wird geöffnet

• URI an entsprechender Stelle einfügen, eure Github-Accountdaten unter

Authentification eingeben -> Next

• Unter source ref den zweiten Eintrag master [branch] wählen -> Add Spec

anklicken -> Next

• Eure Anmeldedaten eingeben und mit Finish abschließen

Projekt clonen

1423841 - Larua Most - 7IMB 10 17.10.2017

• Ein Projekt clonen heißt, eine Kopie eines bereits existierenden Git

repositories anzulegen.

• Dazu auf File klicken -> Import

• Im Import-Dialog auf -> Git -> Project from Git -> Next

• Bei Select Repository Source -> Clone URI auswählen -> Next

• Im Source Git Repository-Dialog unter Location bei URI die URI

einfügen, Felder sollten sich automatisch ausfüllen und bei

Authentification eure Daten von Github einfügen -> Next

Projekt clonen

1423841 - Larua Most - 7IMB 11 17.10.2017

• Branches auswählen -> Next

• Im local destination-Dialog auswählen, wo das Projekt gespeichert

werden soll -> Next

• Unter Wizard for importing projects -> Import exisiting Eclipse

project auswählen -> Next

• Bei Import Project -> mit Klick auf Finish abschließen

Pushen

1423841 - Larua Most - 7IMB 12 17.10.2017

• Um lokale Änderungen auch für andere Nutzer sichtbar zu machen,

müssen sie in das gemeinsam genutzte Github-Repository gepusht

werden.

• Wenn bereits Commits erstellt, aber noch nicht gepusht wurden, wird

hinter dem JavaProject ein ↑ mit Anzahl der Commits angezeigt

• Rechts-Klick -> Team -> Repository -> Push to Upstream

• Alternativ: Direkt beim Committen die Option Commit and Push wählen

Fetch und Pull

1423841 - Larua Most - 7IMB 13 17.10.2017

• Um Änderungen des Projekt vom Github-Repository herunterladen

zu können gibt es zwei Möglichkeiten:

• Fetch lädt die Daten lediglich in das lokales Repository herunter, die

Daten werden aber nicht mit der Arbeitskopie zusammengeführt. Es

besteht also keine Gefahr einer Modifikation der aktuellen Arbeitskopie.

• Pull führt quasi einen fetch aus, versucht aber gleichzeitig die Commits

zusammenzuführen, d.h. zu mergen auch mit dem Code, an dem gerade

gearbeitet wird.

• Rechts-Klick auf das Projekt -> Team -> Fetch from Upstream oder

Rechts-Klick auf das Projekt -> Team -> Pull

Nützliche Links

1423841 - Larua Most - 7IMB 14 17.10.2017

• http://wiki.eclipse.org/EGit/User_Guide

• https://guides.github.com/activities/hello-world/

• https://wiki.eclipse.org/EGit/User_Guide/State#Label_Decorations

• https://git-scm.com/

Hochschule Mannheim University of Applied Sciences

Vielen Dank für Eure Aufmerksamkeit!

1423841 - Larua Most - 7IMB 15 17.10.2017