Einrichten von Git und Visual Studio Code

Anlegen eines neuen Projektes auf GitLab

1. Melden Sie sich auf gitlab.hrz.tu-chemnitz.de an.

2. Erstellen Sie ein neues Projekt.

3. Vergeben Sie einen Namen für das Projekt, bspw. PMR.

4. Fügen Sie Ihre Praktikumsgruppenmitglieder hinzu. Als Rolle sollten Sie Developer, Maintainer oder Owner vergeben.

Einrichten der GitLab-Verbindung auf einem neuen Computer

1. Zunächst müssen Se ein Paar aus öffentlichem und geheien Schlüssel auf Ihrem Computer generieren. Öffnen Sie dazu auf ihrem Rechner ein Terminal und geben Sie folgenden Befehl ein: ssh-keygen -t ed25519 -C "PMR"

2. Sie werden gefragt, in welcher Datei Sie Ihren Key speichern wollen. Sie können einfach ENTER drücken um die voreingestellte Datei zu verwenden. Anschließend können Sie ein Passwort vergeben. Auch hier können Sie einfach ENTER drücken um kein Passwort zu verwenden.

3. Im Normalfall wird Ihr öffentlicher Schlüssel in der Datei ~/.ssh/id_ed25519. pub gespeichert. Mit folgendem Befehl können Sie sich den Schlüssel anzeigen lassen: cat ~/.ssh/id_ed25519.pub

4. Markieren Sie die gesamte Ausgabe und kopieren Sie sie mittels Rechtsklick in die Zwischenablage (STRG-C funktioniert im Terminal nicht)

5. Klicken Sie auf der Website von GitLab auf Ihr Profil (in der linken Seitenleiste, der Button sieht aus wie ein Kreis mit dem Anfangsbuchstaben Ihres Nutzernamens)

6. Klicken Sie auf Preferences

7. Klicken Sie in der Seitenleiste auf SSH Keys

8. Fügen Sie den Key aus der Zwischenablage ein

9. Weiterhin können Sie einen Namen für den Key vergeben (beispielsweise den Namen des Rechners auf dem Sie arbeiten)

10. Achten Sie darauf, dass das Verfallsdatum des Keys (Expiration date) genügend weit in der Zukunft liegt. Ggf. können Sie auch das Verfallsdatum löschen.

11. Klicken Sie auf Add Key

12. Wechseln Sie zurück zum Terminal. Mit folgendem Befehl können Sie testen, ob alles geklappt hat (falls Sie dazu aufgefordert werden, tippen Sie yes ein, um sich mit GitLab zu verbinden): ssh -T git@gitlab.hrz.tu-chemnitz.de

13. Wenn alles funktioniert, werden Sie mit Ihrem Nutzwerkennzeichen begrüßt

14. Um Ihr Projekt herunterzuladen brauchen Sie den dazugehörigen Terminal-Befehl. Navigieren Sie auf GitLab zur Seite Ihres Projektes. Dort finden Sie einen blauen clone-Button. Den korrekten Befehl finden Sie unter clone with SSH. Kopieren Sie diesen Befehl in die Zwischenablage.

15. Öffnen Sie ein neues Terminal. Mit Rechtsklick können Sie nun den clone Befehl einfügen und mit ENTER. Wenn bis hier alles geklappt hat, wird Ihr neu angelegtes Projekt einen neuen Ordner im Home-Verzeichnis geladen.

16. Navigieren Sie mittels cd in das neue Projekt (cd PMR, falls Sie Ihr Projekt PMR genannt haben). Mittels code . können Sie anschließend VSCode in diesem Ordner öffnen und mit dem Programmieren beginnen.

Nutzen des Build-Systems von VS-Code

1. VS-Code arbeitet mit seinem eigenen Build-System, sogenannten Build-Tasks. Diese sind für das Praktikum schon fertig konfiguriert und müssen nur noch in den jeweiligen Projektordner kopiert werden.

2. Im Ordner PMR_Materialien/lib/tools/editor_config/vscode/workspace finden sie einen Versteckten Ordner namens .vscode

3. Kopieren Sie diesen Ordner in Ihren Projektordner. Das kann beispielsweise über einen Dateimanager passieren (beachten Sie, dass Sie die Option setzen müssen, versteckte Dateien anzuzeigen).

4. Bevor es los gehen kann, muss der Roboter in den Programmiermodus versetzt werden. Halten Sie dazu den Taster ganz rechts gedrückt, während Sie den Roboter anschalten. Im Display erscheint Bootloader Vx.x USB

5. Verbinden Sie den Roboter mit einem USB-Kabel mit dem Computer

6. Öffnen Sie die Quelldatei in VS-Code, die Sie kompilieren möchten. Klicken Sie in der Menüleiste oben unter Terminal auf Run Build Task und wählen TUCBot Program aus

7. Wenn alles funktioniert hat, wird das Programm gebaut und übertragen.