Allgemeine Hilfe und Troubleshooting

In dieser Datei findest Du viel allgemeine Hilfe für die folgenden Problemfälle.

        Wie alle Inhalte dieses Projekts findest Du diese auch im Tutorial

• Ich möchte das Tutorial noch einmal ansehen

• Irgend etwas klappt mit 5Code nicht. 

 ---

• Du weisst allgemein nicht, wie Du an die Aufgaben herangehen sollst
  
  

• Es gibt Fehler mit Deinem Code und Du weißt nicht, wie Du damit umgehen sollst
  
  

• Du kannst Dich nicht in den Dateien orientieren
  
  

• Du hast noch keine gute Arbeitsweise gefunden

 

Wenn Du das Tutorial aus der ersten Woche noch einmal einsehen möchtest

Hilfe und ausführlichere Beschreibungen von Features, Eigenschaften, etc. bekommst Du auch über die eingebaute Hilfe, bzw. das Tutorial aus der ersten Woche.

Das bekommst Du auch jederzeit zu sehen, wenn Du im Workspace (Ansicht aller Projekte) auf das Icon klickst.

 

Wenn Du ein technisches Problem mit 5Code hast.

Hast Du 5Code zu Beginn korrekt eingerichtet?

Wenn Du gerade beginnst, mit 5Code zu arbeiten, musst Du darauf achten, dass Du Java, VSCode und/oder 5Code vollständig (!) genauso eingerichtet hast, wie es in der Anleitung steht. Wenn Du dabei etwas auslässt oder nachlässig machst, kann es Probleme geben - wie mit jeder anderen Entwicklungsumgebung (IDE) auch.

Denke insbesondere daran, zu Hause und im Praktikumsraum (wenn Du den dortigen PC benutzt und nicht Deinen Laptop), beim Start von 5Code die gleiche E-Mail-Adresse anzugeben. Nur so kannst Du zu Hause und auf dem Praktikums-PC auf Deine Features und 5Coins zugreifen. 

Halte Dich genau an die Anleitung und installiere die 5Code-Erweiterung noch einmal.

→ Keine Angst, Deine Dateien und Lösungen bleiben dabei erhalten.

Wenn Deine Einstellungen, Features und 5Coins "weg" sind, gibt es unten einen eigenen Punkt dazu.

Meine Einstellungen, Features und 5Coins im Praktikum sind weg

Das kann an zwei Möglichkeiten liegen:

• Du hast mit einem USB-Stick oder über eine Cloud wie OneDrive nur einzelne Projekte zwischen mehreren Rechnern übertragen,

  • Dann werden die Features und 5Coins nicht mitgenommen.

  • Daher: Übertrage immer den gesamten Workspace-Ordner zwischen verschiedenen Rechnern. Dann werden auch Features und 5Coins mitgenommen.

  • Fertig

• Du hast selber unterschiedliche E-Mail-Adressen auf unterschiedlichen Rechnern verwendest. Das ist nicht das, was Du bei der Installation machen solltest!

  • Die Lösung dazu ist daher etwas aufwändiger. Sie wird im Folgenden ausführlich beschrieben:

Die E-Mail-Adresse wird dazu verwendet, Deine eigenen Features und 5Coins zu verschlüsseln (damit sie nicht unter Kommilitonen ausgetauscht werden).

Stelle auf dem Praktikum-Rechner die gleichen E-Mail-Adresse ein, wie zu Hause.

Dazu mussst Du folgendes tun:

• Beende 5Code

• Geh im File-Explorer von Windows zu Deinem Benutzer-Verzeichnis und darin in den versteckten Ordner .5Code (achte auf den Punkt am Anfang), z.B, C:\Users\mdahm\.5code
  bzw.

  • Wenn Du den versteckten Ordner in Deinem Beutzer-Verzeichnis nicht sehen kannst, mach ihn sichtbar durch
     

• Kopiere zur Sicherheit dort das File config.5code in config_org.5Code
  

  • Wenn Du im Folgenden etwas kaputt machen solltest, z.B. durch versehentliches Löschen eines " oder , wie es vorher im File stand, dann kannst Du damit den original-Zustand wiederherstellen, indem Du das kaputte File löschst und config_org.5Code umbenennst in config.5Code

• Öffne dort das File config.5code als Textfile

  • z.B. mit: Rechte Maustaste -> Öffnen mit -> WordPad)

• Ändere in diesem File die angegebene email so, dass sie die gleiche ist, wie auf Deinem eigenen Rechner zu Hause, z.B.: 

           "user": {
                "email": "markus.dahm@hs-duesseldorf.de",
                "name": "Markus Dahm"
            },    

• Speichere dieses File

• Öffne 5Code

→ Nun kannst Du die zu Hause erworbenen Features und 5Coins auch im Praktikum nutzen. Alle im Praktikum erworbenen Features und 5Coins sind damit allerdings verloren. Das sollte aber nicht weiter schlimm sein, da Du sicher im Wesentlichen zu Hause an den Aufgaben arbeitest.

 

Wenn es eine neue Version von 5Code gibt, installiere die auch sofort!

Damit werden bekannte Bugs gefixt und verbesserte Funktionen angeboten.

Es geht schnell und ersetzt die bisherige Version der Erweiterung.

Eine neue Version von 5Code bekommst Du über 5Code.de, wie bei der ersten Installation.

Du installierst sie auch ganz genauso, über

Extensions (Icon in der Sidebar -> ... -> Install from VSIX

 

Meine Lösung von zu Hause sind nicht im Praktikum sichtbar

Dann hast Du höchstwahrscheinlich gedacht, dass Deine Projekte automatisch über das Dashboard von einem Rechner zum anderen übertragen werden. 

Das ist nicht der Fall, auf dem Dashboard kannst Du nur neue Projekte herunterladen. 

Du kannst selber keine Projekte hochladen.

Wenn Du zu Hause einen anderen Rechner verwendest, als im Praktikum, dann musst Du Deinen Workspace-Ordner von zu Hause zum Praktikum übertragen - und auch wieder zurück, wenn Du im Praktikum noch etwas änderst.

• Wie diese Übertragung funktioniert ist im Kapitel Projekte und Workspace beschrieben.

 

Meine Projekte sind weg

Es verschwindet nichts "einfach nur so". Du hast etwas gemacht, was nicht sinnvoll war - was für jede IDE nicht sinnvoll ist, nicht nur in 5Code

Es gibt mehrere Möglichkeiten, Deine Projekte wiederzufinden und weiter zu benutzen:

• Du hast auf Deinem Rechner den Workspace-Ordner, in dem alle Deine Projekte liegen, im  File-Explorer (oder auf dem Mac: im Finder) verschoben. 

  • Dann weiß 5Code nicht, dass Du das gemacht hat

  • Die Projekte sind alle noch da, Du musst 5Code nur sagen, dass der Workspace-Ordner woanders liegt

  • Wie das geht, steht im folgenden Abschnitt "Ich möchte meinen Workspace-Ordner verschieben"

•  Du hast den Workspace-Ordner umbenannt

  • Bennenne ihn wieder wie vorher

  • oder: folge dem folgenden Abschnitt "Ich möchte meinen Workspace-Ordner verschieben" sinngemäß. Der neue Ordner ist dann der umbenannte Ordner.

• Du hast den Workspace-Ordner im Installations/Programm-Ordner von 5Code angelegt

  • Das sollte eigentlich nicht passieren, wir weisen bei der Erstinstallation deutlich darauf hin. Manche schaffen es trotzdem :-(

  • Wenn das der Fall ist, hast Du Pech: Bei einem Update von 5Code wird der Installations/Programm-Ordner von 5Code gelöscht und neu angelegt.

  • Dann sind auch Deine eigenen Projekte gelöscht. Sie können nur dann wieder hergestellt werden, wenn Du ein Backup angelegt hast.

    • Dann stelle sie aus Deinem Backup wieder her und lege einen neuen Workspace-Ordner in Deinem Nutzer-Bereich an.

• Dein Workspace-Ordner liegt auf einem Cloud-Ordner, z.B. bei Microsoft OneDrive, GoogleDrive, iCloud, etc. - und Du hast keine Verbindung zu dieser Cloud

  • Versuche, die Verbindung wiederherzustellen. Ggf. frage eine*n Betreuer*in.

 

Ich möchte meinen Workspace-Ordner verschieben

Bei der Erst-Einrichtung von 5Code wurde Dir geraten, den Workspace-Ordner in einer sinnvollen Ordner-Struktur anzulegen, z.B. 

C:\Users\Jules\HSD\Semester 1\OOP\Praktikum\Projekte

Wenn Du das zuerst nicht gemacht hast, und das nachholen möchtest, musst Du in VSC den neuen Workspace-Ordner öffnen - automatisch kann er nicht (!) gefunden werden. 

Über das Menü File -> Open Folder... kannst Du einfach den aktuell verwendeten Workspace-Ordner wechseln.

• Dann werden auf dem Dashboard Deine Projekte, Features und 5Coins wie vorher angezeigt.

 

Auf meinem Mac klappt es nicht

"Eigentlich" funktioniert VSCode und 5Code auch auf Mac-Rechnern genauso, wie auf Windows oder Linux.

An manchen Stellen braucht ein Mac aber z.B. die Erlaubnis, dass VSC oder 5Code auf ein bestimmtes Verzeichnis schreiben darf, oder dass Du VSC oder 5Code im Ordner Programme installieren darfst, oder dass 5Code auch als Programm gestartet werden kann.

→ Guck dazu nochmal in die Installations-Anleitung für den Mac, dort wird beschrieben, wie vorzugehen ist.

 

Wenn es komisches Verhalten von 5Code gibt

Das liegt häufig daran, dass ältere Projekte von vorangegangenen Semestern kopiert werden. Diese sind nicht (vollständig) kompatibel und machen häufig Probleme.

Starte neu mit dem aktuellen Projekt, lade es herunter und und bearbeite es selber - nur so lernst Du auch!

Wenn es dann immer noch komisches Verhalten gibt, dann 

• Frage eine*n Betreuer*in

• Wenn Dein Problem nicht gelöst werden kann, schreib uns eine Mail, siehe unten

 

Wenn Du Schwierigkeiten mit den Funktionen in der Knowledge Map hast

Das liegt häufig daran, dass ältere Maps von vorangegangenen Semestern kopiert werden. Diese sind nicht (vollständig) kompatibel und machen häufig Probleme.

Starte mit einer frischen Map und bearbeite sie selber - nur so lernst Du auch:

• Lösche die Map im Dashboard und die ggf. vorhandene .Map-Datei(en) (lokal auf Deinem Rechner)

• Lade die dann im Dashboard angebotene Map "Knowledge.5map" frisch herunter

• Öffne dann nur noch diese Knowledge Map durch Klick auf die Begriffe im Aufgabendokument.

 

Melde uns den Fehler, wir kümmern uns darum

Wenn 5Code nicht so funktioniert, wie Du es erwartest, kannst Du immer Hilfe bekommen durch eine Mail an feedback@5code.de.

→ Wir können Dir am besten helfen, wenn Du uns den Fehler kurz und klar beschreibst, am besten

• mit einem beschreibenden Text

• und einem Screenshot

• und auch noch sagst, ob Du Windows, Mac oder Linux benutzt,

• und welche Version von 5Code (steht unten rechts im Fenster).

 

Wenn Du nicht weißt, wie Du an die Aufgaben herangehen sollst

Wenn Du "planlos" an der Lösung der Aufgabe herumprobierst.

Irgendetwas zu machen, nur um etwas zu tun ist sowohl frustrierend, als auch sehr zeitfressend. Das kannst Du aber "einfach" verbessern:

Arbeite alle einzelnen Schritte Lesen - Verstehen - Überlegen - Aufschreiben - Codieren der Reihe nach durch. So arbeitest Du zielgerichtet und sicherer, weil Du immer weißt, was Du tun sollst. Wenn Du es nicht weißt, gehe einen Schritt zurück.

Wenn Du eine Aufgabe nicht wirklich verstehst, lies sie konzentriert durch. Oft findest Du konkrete Hilfestellungen in den "Lesen"- und "Verstehen"-Abschnitten direkt bei der Aufgabenstellung.

Wenn Du Deine Lösung überlegst, mach das zuerst auf Deutsch, schreibe Deine Gedanken dann als //-Kommentar in Deinen Code. Dann erst setze diese Gedanken in Java um.

Wenn Du nicht weißt, wie Du Deine Lösung in Java codieren sollst, findest Du Hilfestellungen zur Lösung in Java oft in den "Überlegen"-Abschnitten direkt bei der Aufgabenstellung.

Um auf eine Lösung in Java zu kommen, um Code zu schreiben, musst Du die (theoretischen) Konzepte von Programmiersprachen verstanden haben. Diese findest Du vor allem in den Vorlesungsmaterialien.

Zusätzlich können Dir auch andere externe Quellen wie Online-Dokumentationen, Java-Referenzbücher, Videos oder ChatGPT helfen, die Bedeutung einzelner Syntax-Elemente und Konzepte zu verstehen.

Die einzelnen Schritte werden nun noch einmal im Einzelnen besprochen.

Wenn Du die Aufgabe nicht (ganz) verstanden hast.

Lies die Aufgabenstellung gründlich durch, um alle Anforderungen und Details zu verstehen.

Vielleicht hast Du auch ein paar Hinweise im Text darüber übersehen.

Häufig bauen die Aufgaben aufeinander auf. Bearbeite Sie daher immer in der angegebenen Reihenfolge.

Oft findest Du konkrete Hilfestellungen in den "Lesen"- und "Verstehen"-Abschnitten direkt bei der Aufgabenstellung.

Verwende einen Textmarker, um wichtige Abschnitte zu markieren, und mache Notizen, um die wesentlichen Punkte zu erfassen.

Wenn Du nicht weißt, wie Du die Aufgabe mit Hilfe von Java lösen sollst.

Hilfestellungen zur Lösung in Java findest Du oft in den "Überlegen"-Abschnitten direkt bei der Aufgabenstellung. Auch bereits gelöste ähnliche Aufgaben können helfen.

Du kannst auch Quellen wie die Vorlesungsmaterialien oder externe Quellen wie Videos oder ChatGPT nutzen, um zu einer Lösung zu kommen.

Wenn Du die Aufgabe gelöst hast, aber dir unsicher bist, ob dein Lösungsansatz korrekt ist.

Im Aufgabentext steht, was Deine Lösung ergeben soll. Vergleiche das mit dem Ergebnis Deiner Lösung.

Du kannst Deine Lösung auch immer automatisch bewerten lassen. Du bekommst dann Rückmeldung sowohl zum Ergebnis Deines Codes, als auch zu Deinem Code selber, wie Du ihn geschrieben hast.

Die Bewertung kannst Du mit einem Klick auf die Bewertungs-Icons (Quadrate, Kreise) an der Aufgabe starten.

 

Wenn Du noch keine gute Arbeitsweise für Dich gefunden hast

Wenn es dir schwerfällt, dich auf die Aufgabe zu konzentrieren.

Um deine Konzentration über längere Zeiträume aufrechtzuerhalten, ist es wichtig, deine Arbeitszeit effektiv zu strukturieren.

• Reduziere Ablenkungen, indem Du dein Arbeitsumfeld optimierst und nicht benötigte Geräte ausschaltest.

• Nutze kurze, produktive Pausen für Aktivitäten wie Strecken, tiefes Atmen oder kurze Spaziergänge, um deine Konzentration zu erneuern.

• Wähle Pausenaktivitäten, die dir helfen, dich zu erholen und neue Energie zu gewinnen.

• Gestalte deine Arbeitsumgebung ergonomisch:

  • Stelle Deinen Bildschirm und die Tastatur so auf, dass Du ohne einen Buckel sehen und schreiben kannst.

  • Sorge für ausreichende Beleuchtung, um Ermüdung vorzubeugen.

Für Deine Konzentration ist es außerdem gut, wenn Du jedesmal systematisch alle einzelnen Schritte Lesen - Verstehen - Überlegen - Aufschreiben - Codieren der Reihe nach durcharbeitest.

Wenn Du dich leicht ablenken lässt, zum Beispiel durch TikTok, Instagram usw.

Das ist für Dich ungünstig. So brauchst Du länger, um die Aufgabe zu bearbeiten.

Versuche, Dich nicht ablenken zu lassen und Dich zu konzentrieren.

• Lege Dein Smartphone außer Sicht- und Hörweite

• Schließe die ablenkenden Tabs in Deinem Browser

Das ist leichter gesagt als getan, es lohnt sich aber für Dich. So kommst Du besser mit der Aufgabe zurecht, es geht schneller, Du verstehst besser, was Du tust und Du fühlst Dich insgesamt sicherer.

Für Deine Konzentration ist es außerdem gut, wenn Du jedesmal systematisch alle einzelnen Schritte Lesen - Verstehen - Überlegen - Aufschreiben - Codieren der Reihe nach durcharbeitest.

Wenn Du keine Lehrmaterialien nutzt.

Du bearbeitest Praktikumsaufgaben, um die theoretisch in der Vorlesung behandelten Themen praktisch umzusetzen und so wirklich zu erlernen und zu beherrschen. Du kannst die Praktikumsaufgaben aber nur dann (!) verstehen, wenn Du die Themen verstanden hast. Wenn Du die Themen jetzt noch nicht beherrschst, musst Du sie nun zuerst lernen

Du findest dazu natürlich alles in den Vorlesungsmaterialien (Skripte, Videos).

Zusätzlich können Dir auch externe Quellen wie Online-Dokumentationen, Java-Bücher, Videos oder (mit Vorsicht) KI helfen, die Bedeutung einzelner Syntax-Elemente und Konzepte zu verstehen.

Wenn Du dich von der Aufgabenstellung überfordert fühlst.

Die Aufgaben sind schon für Dich in viele kleine Teile aufgeteilt worden, damit Du Dich immer nur mit einem kleinen Teil befassen musst. Die Aufgaben bauen außerdem häufig aufeinander auf - bearbeite sie also der angegebenen Reihe nach und spring nicht zu späteren Aufgaben. So verstehst Du alles viel besser.

Die Aufgabenstellungen passen immer genau zum Thema, das in der vorangegangenen Vorlesung behandelt wurde. Wenn Du nicht verstehst, was gefordert wird, solltest Du auf jeden Fall zuerst die letzte Vorlesung nacharbeiten. Dafür stehen dir sowohl das PDF-Skript als auch Videos zur Verfügung.

Falls Du weitere Fragen hast, kannst Du dich auch an andere Studierende wenden oder den Chatbot in 5Code um Hilfe bitten.

Wenn Du dich gehetzt fühlst oder nicht viel Zeit für das Finden einer Lösung zur Verfügung hast.

Es klingt komisch und unsinnig, aber: Wenn Du es eilig hast, mach langsam, und arbeite konzentriert. Arbeite alle einzelnen Schritte Lesen - Verstehen - Überlegen - Aufschreiben - Codieren systematisch der Reihe nach durch.

So weißt Du immer, was Du tun sollst, und was als nächstes dran kommt. Das braucht normalerweise insgesamt deutlich weniger Zeit, als wenn Du möglichst schnell irgend etwas versuchst zu Codieren, was dann aber wenig mit der Aufgabe zu tun hat - und was Du dann wieder korrigieren musst.

 

Wenn nicht weisst, wie Du mit Fehlern umgehen sollst

Wenn Du Angst davor hast, Fehler zu machen.

Gerade zu Beginn kann es frustrierend sein, wenn der Compiler (Dein Freund ;-) Dir häufig Fehler in Deinem Code meldet.

Es klingt abgedroschen und wenig hilfreich, aber: Fehler gehören immer zum Lernen und zum Arbeiten dazu. Niemand ist ohne Fehler. Aus Fehlern lernt man. Das gehört zum Studieren, das gehört aber auch zum Alltag im Beruf.

Du solltest also lernen, wie Du mit Fehlern so umgehst, dass Du daraus schlauer wirst.

Konkret bei Fehlermeldungen des Compilers heißt das: Lies die Fehlermeldung, verstehe sie! Zu jeder Fehlermeldung gibt es auch ausführlichere Erklärungen. Lies diese und verstehe sie. Dann weißt Du beim nächsten Mal, was Du besser machen muss - idealerweise schon beim Schreiben des Codes.

Wenn Du dir unsicher bei der Java-Syntax bist.

In den Vorlesungsmaterialien findest Du immer alle notwendigen Informationen.

Außerdem kannst Du auch externe Quellen wie Online-Dokumentationen, Java-Referenzbücher, Videos oder KI nutzen, um die richtige Java-Syntax zu erlernen. Beachte, dass bestimmte sprachspezifische Features erst in späteren Java-Versionen verfügbar sind.

Wenn Du Probleme damit hast, einen Syntaxfehler zu beheben.

Entsteht beim Kompilieren des Programms ein Fehler, wird dieser auf der Konsole ausgegeben.

Syntaxfehler werden beim Kompilieren oder Interpretieren des Quellcodes erkannt und müssen durch Korrektur der Syntax behoben werden.

Durch einen Klick auf die Zeilennummer kannst Du zum Ursprung dieser Fehlermeldung im Quellcode navigieren. Darüber hinaus kannst Du dir zusätzliche Erläuterungen zum Fehler anzeigen lassen, wenn Du auf den Link "Erläuterung zum Fehler" in der Konsole klickst.

Wenn Du alle Probleme im Quellcode behoben hast, trotzdem aber beim Ausführen der Anwendung Fehler auftreten.

Laufzeitfehler treten erst zur Laufzeit deines Programms auf und deuten auf einen logischen Fehler in deiner Anwendung hin. Diese Fehler können auftreten, wenn das Programm versucht, eine ungültige Operation auszuführen, wie z.B. Division durch Null. Entsteht beim Ausführen des Programms ein Fehler, wird dieser auf der Konsole ausgegeben.

Das Beheben dieser Fehler erfordert oft Debugging und eine Analyse der Logik des Programms. Durch einen Klick auf die Zeilennummer kannst Du zum Ursprung dieser Fehlermeldung im Quellcode navigieren.

Darüber hinaus kannst Du dir zusätzliche Erläuterungen zum Fehler anzeigen lassen, wenn Du auf den Link "Erläuterung zum Fehler" in der Konsole klickst.

 

Wenn Du Dich nicht in Deinem Code oder der Aufgabe zurechtfindest

Wenn Du dich in deinem eigenen Quellcode nicht zurechtfindest.

Das richtige, logische, sinnvolle Einrücken von Quellcode verbessert die Lesbarkeit und Struktur. Das machst Du bei Verzweigungen, Schleifen und der Definition von Prozeduren und Funktionen. So weißt Du immer, welche Zeilen zusammengehören und behältst den Überblick. 

Nutze Kommentare, um Abschnitte zu erklären, was sowohl anderen als auch dir selbst hilft.

Teile den Code in kleinere, logische Funktionen oder Klassen auf und benenne Variablen, Funktionen und Klassen klar und aussagekräftig.

Vermeide zu allgemeine oder abkürzende Namen.

Nutze den Code-Explorer für schnelle Navigation zwischen Dateien und Klassen, um den Kontext zu verstehen und Beziehungen zwischen verschiedenen Teilen deines Codes zu erkennen.

Wenn Du nach einer bestimmten Stelle im Quellcode suchst.

Für eine projektübergreifende Suche über alle Aufgaben kannst Du die Suchfunktion in der Seitenleiste verwenden (oder über Strg-Shift-F). Strg-F ermöglicht dir eine schnelle Suche im ausgewählten Dokument.

Verwende die Code-Outlin und die Verlinkungen zwischen Aufgabenstellung und Quellcode, um direkt zu den relevanten Stellen zu gelangen.

Denke daran, dass das Einrücken deines Quellcodes dazu beiträgt, ihn übersichtlich und lesbar zu halten.

Wenn Du nach einer bestimmten Stelle in der Aufgabenstellung suchst.

Für eine projektübergreifende Suche über alle Aufgaben kannst Du die Suchfunktion in der Seitenleiste verwenden (oder über Strg-Shift-F).

Strg-F ermöglicht Dir eine schnelle Suche im ausgewählten Dokument.

Verwende den Textmarker, um wichtige Abschnitte zu markieren, und mache Dir Notizen, um die wesentlichen Punkte hervorzuheben.