Link Search Menu Expand Document

Java Setup

Installation

trifft auf weichware10/toolbox und weichware10/analyse zu

1. fertig kompiliert:

  • Installer-Datei von Releases herunterladen
    • .msi: Windows
    • .deb: Linux
    • .dmg: MacOS
  • diese Dateien werden auch bei jedem Durchlauf des test-Workflows erstellt und sind dort herunterzuladen (nach Pushes auf main und in Pull Requests)

2. selbst kompilieren:

  • Repository clonen
  • mvn clean install laufen lassen
  • die benötigten JMODs für das richtige Betriebssystem werden automatisch heruntergeladen (manuell durch mvn validate möglich)
  • die erzeugte Installer-Datei befindet sich im target-Verzeichnis

Achtung: die Versionsnummern unterscheiden sich zwischen den beiden Optionen. Falls zwischen fertig kompiliert und selbst kompiliert gewechselt wird, könnte eine vorherige Deinstallation unter Umständen nötig sein.

Starten ohne Installation in Entwicklungsumgebung (VSCode)

  • Herunterladen der JavaFX-SDK auf gluonhq.com
  • Erstellen einer launch.json im Verzeichnis .vscode:
    // .vscode/launch.json
    {
        "version": "0.2.0",
        "configurations": [
            {
                "type": "java",
                "name": "Launch Toolbox",
                "request": "launch",
                "vmArgs": "--module-path=C:/javafx-sdk-17.0.1/lib --add-modules=javafx.controls --add-modules=javafx.fxml",
                "mainClass": "github.weichware10.toolbox.Main",
                "projectName": "toolbox"
            }
        ]
    }
    
    • --module-path=C:/javafx-sdk-17.0.1/lib sollte je nach lokaler Installation angepasst werden, sodass es das lib-Verzeichnis der JavaFX-SDK referenziert

Maven Lifecycle

mvn clean "Aufräumen" der Entwicklungsumgebung (Löschen des target-Verzeichnis)
mvn validate Ausführen von Checkstyle, Herunterladen von plattformspezifischen JavaFX-JMODs
mvn test Ausführen der Tests
mvn install Erstellen einer plattformspezifischen Installer-Datei
mvn package Alle Schritte bis auf erstellen der Installer-Datei durchführen
mvn site verschiedene Plugins erstellen HTML-Dateien mit Informationen über das Projekt

Table of contents