Installations‐ & Setup‐Anleitungen - Robust-Games/robust GitHub Wiki

1. Setup

  1. Java Development Kit (JDK) 21
  2. Git (für Versionskontrolle)
  3. Gradle
  4. IntelliJ IDEA (Community oder Ultimate Edition)
  5. Internetverbindung für initiales Dependency-Setup
  6. Tiled (für Tilemaps)
  7. Aseprite (für Animationen/Pixeldesign)

Weiteres für die Dokumentation: https://github.com/Robust-Games/robust/wiki/Technologien


2. Schritt-für-Schritt-Anleitung für lokale Installation

2.1 Java Development Kit (JDK) 21

sudo apt update
sudo apt install openjdk-21-jdk
echo 'export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64' >> ~/.bashrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Prüfen mit:

echo $JAVA_HOME
java -version

2.3 Git

sudo apt install git

2.4 Gradle

wget https://services.gradle.org/distributions/gradle-8.7-bin.zip
unzip gradle-8.7-bin.zip -d /opt/gradle
echo 'export PATH=$PATH:/opt/gradle/gradle-8.7/bin' >> ~/.bashrc
source ~/.bashrc
gradle -v

2.5 IntelliJ IDEA installieren

Lade IntelliJ IDEA herunter und installiere es: https://www.jetbrains.com/idea/download/

sudo apt update
sudo apt install openjdk-21-jdk
echo 'export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64' >> ~/.bashrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Prüfe:

echo $JAVA_HOME
java -version

3. Projekt klonen oder Alternativ direkt als Projekt in IntelliJ öffnen

3.1 Projekt klonen:

Über HTTPS im Terminal Klonen:

git clone https://github.com/Robust-Games/robust.git
cd robust

3.2 Projekt direkt als Projekt in IntelliJ öffnen:

Üder HTTPS in der IntelliJIDE: Öffne IntelliJ New Project mit VSC In URL-Feld einfügen: https://github.com/Robust-Games/robust.git Klicke: Clone

3.3PGitHub-Zugriff in IntelliJ IDEA mit Personal Access Token (PAT)

3.3.1 Token auf GitHub erstellen:

https://github.com/settings/tokens

3.3.2 Token in IntelliJ einrichten:

Öffne IntelliJ IDEA : File > Settings > Version Control > GitHub Klicke auf das +, um ein neues Konto hinzuzufügen Wähle: Log In via Token Füge den kopierten Token ein Bestätige mit Login

3.3.3 Prüfe: Git Pull/Push

Öffne dein Projekt VCS → Git → Pull oder Push Wenn der Token korrekt ist, wird keine weitere Authentifizierung benötigt

3.5 Abhängigkeiten herunterladen

IntelliJ lädt die Abhängigkeiten automatisch (JavaFX, FXGL, JUnit). Bei Problemen run:

./gradlew clean build --refresh-dependencies 

3.6 Build und Tests ausführen

./gradlew

oder in IntelliJ über das Build- und Test-Tool.

4. Assets bearbeiten


5. Deployment-Details

GitHub dient als zentrale Versionsverwaltung mit CI/CD-Plattform.

CI/CD-Pipeline automatisiert:

  • Build-Prozess
  • Testausführung (JUnit)

4. Hinweise

4.1 Linux-Spezifisch:

4.2 Windows-Spezifisch:

4.3 Mac-Spezifisch: