Herunterladen und Importieren von Hausübungen in IntelliJ
Zum Bearbeiten der Hausübungen benötigen Sie die von uns zur Verfügung gestellten Vorlagen. Diese erhalten sie entweder, indem sie das zugehörige Git-Repository klonen, oder die Zip-Datei von Moodle herunterladen.
Warnung
Speichern Sie die Vorlage an einem Dateipfad, welcher keine Leerzeichen oder Sonderzeichen enthält. Dies kann u.U. zu Problemen führen.
Importieren der Vorlage
- Um die Repositories mit Git zu klonen, müssen Sie zunächst Git lokal installieren.
Repositories klonen
Achtung
Forken Sie nicht die Repositories. Auf Forks hat jeder Zugriff, weshalb diese als Plagiarismus gewertet werden und Ihre Abgabe dann eventuell nicht von uns bewertet werden kann.
- IntelliJ bietet Ihnen die Möglichkeit, Git-Repositories automatisch zu klonen. Gehen Sie dafür links oben auf die drei Punkte und dann im "File" Reiter "New" -> "Project From Version Control..." aus.
- Wenn Sie IntelliJ das erste Mal starten oder momentan kein Projekt geöffnet haben, müssen Sie stattdessen rechts oben auf "Get from VCS" drücken.
- Geben Sie nun bei "URL" die URL zum Repository der entsprechenden Hausübungen ein.
- Ein Link zu den entsprechenden Repositories finden Sie auf Moodle.
- Wählen Sie bei "Directory" den Ort aus, an dem Sie das Projekt speichern möchten.
- Drücken Sie nun auf "Clone", um das Repository zu klonen.
- Falls Sie bereits ein Projekt geöffnet hatten, drücken Sie auf "This Window".
- Nachdem das Klonen abgeschlossen ist, drücken Sie auf "Trust Project", wodurch sich die Vorlage öffnet.
- Nun können Sie die Hausübung bearbeiten.
Achtung
Wir empfehlen Ihnen für die Hausübungen Git zu verwenden.
- Alternativ können Sie auch mit der bereitgestellten Zip-Datei arbeiten. Laden Sie sich dafür aus dem Moodle Kurs die Zip-Datei der Vorlage für die entsprechende Hausübung herunter.
- Entpacken Sie die Zip-Datei und speichern Sie den entpackten Ordner an einem Ort Ihrer Wahl.
- Unter Windows können Sie Zip-Dateien entpacken, indem Sie im File Explorer einen Rechtsklick auf die Datei machen und auf "Alles extrahieren..." drücken. Nachdem Sie einen Speicherort angeben haben, müssen Sie noch auf "extrahieren" drücken, um die Datei zu entpacken.
- Unter macOS können Sie Zip-Dateien entpacken, indem Sie im Finder einen Doppelklick auf diese machen.
- Gehen Sie nun in IntelliJ links oben im "File" Reiter auf "open..."
- Wenn Sie IntelliJ das erste Mal öffnen, drücken Sie stattdessen rechts oben auf "open"
- Wählen Sie nun den Pfad zu dem Ordner, in dem die Vorlage gespeichert ist, aus und drücken Sie auf "OK".
- Achten Sie darauf, dass Sie den richtigen Ordner importieren. Der Ordner sollte nach der Hausübung benannt sein (z. B. "FOP-2324-HXX-Student-master") und direkt die build.gradle.kts Datei enthalten sein. Wählen Sie beim Importieren nicht einen identisch benannten Oberordner aus.
- Falls Sie bereits ein Projekt geöffnet hatten, drücken Sie auf "This Window".
- Drücken Sie zum Schluss auf "Trust Project", wodurch sich die Vorlage öffnet.
- Nun können Sie die Hausübung bearbeiten.
Aktualisieren der Vorlage
- Es kann vorkommen, dass wir nach der Veröffentlichung der Vorlage noch Änderungen an dieser vornehmen.
- Die Abgabe ist in i.d.R. mit jeder Version der Vorlage möglich.
- Wenn Sie die Vorlage mithilfe von Git geklont haben, können Sie sich die neuste Version der Vorlage ganz einfach herunterladen.
- In IntelliJ gibt es eine Git Integration, die alle benötigten Befehle für Sie ausführt. Die Befehle stehen hier trotzdem nochmal dabei, falls Sie nicht mit IntelliJ arbeiten.
- Zunächst müssen Sie Ihre Änderungen commiten. Öffnen Sie dafür in IntelliJ am linken oberen Rand die Commit-Ansicht, wählen Sie alle Dateien aus, die Sie bearbeitet haben, geben Sie eine commit Message und drücken Sie auf "Commit".
- Alternativ können Sie die Commit-Ansicht auch über "View" -> "Tool Windows" -> "Commit" öffnen.
- Falls das Commiten fehlschlägt, weil gewisse checks nicht erfolgreich durchlaufen, drücken Sie auf "Commit Anyway".
- Alternativer Befehl:
- Nun können Sie die Änderungen zu Ihrer Version hinzuzufügen, indem Sie links oben in IntelliJ auf die drei Punkte gehen und dann im Git Reiter auf "Pull..." drücken. Drücken Sie im Fenster, welches sich nun öffnet, erneut auf "Pull".
- Alternativer Befehl:
- Falls sich die Änderungen nicht im master branch befinden, müssen sie stattdessen die Änderungen in Ihren master branch mergen. Drücken Sie dafür im Git Reiter oben links auf "Fetch" und danach auf "Merge". Geben Sie in dem Fenster, welches sich nun öffnet, rechts den Branch an, in welchem sich die Änderungen befinden. Drücken Sie dafür rechts auf den Pfeil nach unten oder geben Sie manuell den Namen ein. Drücken Sie zum Schluss auf "Merge".
- Falls Sie sich unsicher sind, welchen branch Sie auswählen sollen, finden Sie unten links unten in der Git Ansicht eine Übersicht aller branches und mit einem Doppelklick auf diese eine Liste aller commits.
- Alternative Befehle: und
- Auch, wenn wir es nicht empfehlen, können Sie die Vorlage alternativ manuell updaten. Kopieren Sie dafür entweder Ihre Implementation in die neue Vorlage oder die Änderungen aus der neuen Vorlage in die alte Vorlage.