Skip to content

Latest commit

 

History

History
228 lines (164 loc) · 7.83 KB

File metadata and controls

228 lines (164 loc) · 7.83 KB

TBuild - Build Tool

License: MIT Java Version

TBuild ist ein starkes, benutzerfreundliches Build-Tool, das für die Verwaltung von Projektabhängigkeiten und das Verpacken von Anwendungen entwickelt wurde. Es vereinfacht den Build-Prozess mit einer vollständigen grafischen Benutzeroberfläche, so dass du niemals XML-Dateien manuell bearbeiten musst. Für die Automatisierung bietet TBuild auch einen umfassenden CLI-Modus. Keine Komplexität, nur Einfachheit.

Features

  • Abhängigkeitsverwaltung - Einfache Verwaltung von Projektabhängigkeiten über die GUI
  • Projektverpackung - Effizientes Verpacken deiner Anwendungen
  • Grafische Benutzeroberfläche - Vollständige GUI-Unterstützung - kein manuelles XML-Bearbeiten nötig
  • CLI-Modus - Vollständiges Kommandozeilen-Interface für Automatisierung und Scripting
  • Projekt-Initialisierung - Schnelle Einrichtung neuer Projekte mit Standard-Strukturen
  • Leichtgewicht - Schnelle Performance und geringer Ressourcenverbrauch
  • Plattformunabhängig - Läuft auf Windows, Linux und macOS (alle Java-unterstützenden Systeme)
  • GUI mit Java Swing - Native und responsive Benutzeroberfläche
  • Keine Telemetrie - Deine Daten bleiben deine Daten, kein Tracking
  • Integration - Nahtlose Integration mit der TIDE IDE

Anforderungen

  • Java 21 oder höher (mit jpackage-Unterstützung für Installer)
  • Mindestens 512 MB RAM
  • 50 MB freier Festplattenspeicher

Installation und Verwendung

JAR herunterladen und ausführen

  1. Stelle sicher, dass Java auf deinem System installiert ist:

    java -version
  2. Lade die neueste TBuild.jar von der Releases-Seite herunter oder nutze die vorkompilierte JAR in diesem Repository

  3. Führe die JAR-Datei aus:

    java -jar TBuild.jar
  4. Das TBuild Tool wird sich öffnen und ist bereit zur Verwendung.

Wie funktioniert TBuild?

GUI-Modus - Projektmanagement

Die grafische Benutzeroberfläche von TBuild macht Projektmanagement intuitiv:

  1. Projekt initialisieren: Klicke auf den "Init"-Button in der GUI
  2. Abhängigkeiten konfigurieren: Nutze die Maven-Suche, um Abhängigkeiten hinzuzufügen
  3. Build-Optionen einstellen: Konfiguriere Ausgabe, Hauptklasse und weitere Einstellungen
  4. Projekt bauen: Nutze den "Nur Build"- oder "Bauen+Run"-Button zum Kompilieren
  5. Ergebnisse einsehen: Sieh dir Build-Ausgabe und eventuelle Fehler in der Konsole an

CLI-Modus - Automatisierung

Für Automatisierung und CI/CD-Pipelines nutze TBuilds CLI:

# Neues Standard-Projekt initialisieren
java -jar TBuild.jar init

# Neues JavaFX-Projekt initialisieren
java -jar TBuild.jar init-javafx

# Projekt kompilieren und ausführen
java -jar TBuild.jar build

# Tests ausführen
java -jar TBuild.jar test

# Als kleine JAR exportieren (ohne Abhängigkeiten)
java -jar TBuild.jar export-small

# Als Fat-JAR exportieren (mit Abhängigkeiten)
java -jar TBuild.jar export

# Bauen und Fat-JAR erstellen (nützlich für CI/CD)
java -jar TBuild.jar build-export-fat

# Nativen Installer erstellen (Windows MSI, Linux DEB, macOS DMG)
java -jar TBuild.jar jpackage

# Hauptklasse setzen
java -jar TBuild.jar set-main com.example.MeineHauptklasse

# Version setzen
java -jar TBuild.jar set-version 2.0.0

Beispiel Projekte

Die folgenden Programme werden mit TBuild verwaltet:

  1. TIDE (https://github.com/Thillager/TIDE)
  2. TBuild (https://github.com/Thillager/TBuild)
  3. leer
  4. leer

Projektstruktur

Project/
├── src/
│   ├── main/
│   │   └── java/             # Java-Source-Dateien
│   └── test/
│       └── java/             # JUnit-Test-Dateien
├── libs/                      # Externe Bibliotheken und Abhängigkeiten
├── out/                       # Kompilierte Ausgabe und Build-Artefakte
├── T.xml                      # Projektkonfiguration (auto-verwaltet)

Konfiguration

TBuild verwaltet die T.xml-Datei automatisch über seine GUI. Kein manuelles Bearbeiten erforderlich!

Die T.xml enthält deine Projektkonfiguration:

<?xml version="1.0" encoding="UTF-8"?>
<project>
  <mainClass>Main</mainClass>             <!-- Hauptklasse zum Ausführen -->
  <appName>MeineApp</appName>             <!-- Anwendungsname -->
  <version>1.0.0</version>                <!-- Versions-String -->
  <winUpgradeUuid>...</winUpgradeUuid>    <!-- Windows Installer UUID -->
</project>

GUI-Konfiguration

Nutze einfach die grafische Benutzeroberfläche von TBuild, um:

  • Projektnamen und Version zu setzen
  • Abhängigkeiten zu verwalten (Maven Central Suche)
  • Build-Optionen zu konfigurieren
  • Ausgabeformate zu wählen

Alle Änderungen werden automatisch in T.xml gespeichert.

Beispiel: Erstes Projekt mit TBuild

Schritt 1: TBuild starten

java -jar TBuild.jar

Schritt 2: Neues Projekt erstellen

Klicke auf den "Init"-Button um ein neues Projekt zu initialisieren.

Schritt 3: Abhängigkeiten hinzufügen

Nutze die Maven-Suche im rechten Panel, um Bibliotheken zu suchen und hinzuzufügen.

Schritt 4: Deinen Code schreiben

Füge deine Java-Source-Dateien zum src/main/java/-Verzeichnis hinzu.

Schritt 5: Bauen und Verpacken

  • Klicke den Nur Build-Button zum Kompilieren deines Projekts
  • Klicke den Fat JAR-Button, um ein Verteilungspaket zu erstellen

Updates

Häufigkeit

  • Es kommen Updates wann immer ich Zeit finde, Ideen habe oder Fehler beheben muss.

Troubleshooting

Problem: "Java nicht gefunden"

Lösung: Installiere Java Runtime Environment (JRE) 21 oder höher von java.com

Problem: JAR-Datei lässt sich nicht ausführen

Lösung:

# Überprüfe Java-Version
java -version

# Stelle sicher, dass du Java 21 oder höher hast
# Führe mit explizitem Pfad aus
java -jar /pfad/zu/TBuild.jar

Problem: Build schlägt mit Abhängigkeitsfehlern fehl

Lösung:

  • Nutze die Maven-Suche im rechten Panel, um Abhängigkeiten zu überprüfen und hinzuzufügen
  • Sieh dir das Build-Log in der Konsole für detaillierte Fehlermeldungen an
  • Überprüfe deine Internetverbindung zum Herunterladen von Abhängigkeiten

Problem: CLI-Befehle werden nicht erkannt

Lösung:

# Verfügbare CLI-Befehle durch Ausführung eines ungültigen Befehls anzeigen
java -jar TBuild.jar ungültiger-befehl

Dokumentation und Links

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Siehe LICENSE für Details. In diesem Projekt werden Dependencies genutzt. Die nötigen Lizenzen stehen in THIRD_PARTY_LICENSES.md.

Built With

TBuild nutzt die Power bewährter Open-Source-Bibliotheken für zuverlässiges Abhängigkeitsmanagement und Build-Fähigkeiten.

Beitragen

Beiträge sind willkommen! Um beizutragen:

  1. Forke das Repository
  2. Erstelle einen Feature-Branch (git checkout -b feature/AmazingFeature)
  3. Committe deine Änderungen (git commit -m 'Add some AmazingFeature')
  4. Pushe zu dem Branch (git push origin feature/AmazingFeature)
  5. Öffne einen Pull Request

Fragen und Support

Falls du Fragen oder Probleme hast:

  • Öffne ein GitHub Issue
  • Sieh dir existierende Issues an für häufig gestellte Fragen

Maintainer: @Thillager

Viel Erfolg beim Bauen mit TBuild!