Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- getting-started [2021/12/17 09:29] – [Systemvorraussetzungen] Michael Lösler
+++ getting-started [2025/03/02 12:00] (aktuell) – Michael Lösler
@@ Zeile 6: / Zeile 6: @@
 ===== Download =====
-[[https://github.com/loesler/applied-geodesy/releases/latest|Java·Applied·Geodesy·3D]] — aktuelle Version kostenlos herunterladen.
+[[https://github.com/applied-geodesy/jag3d/releases/latest|Java·Applied·Geodesy·3D]] — aktuelle Version kostenlos herunterladen.
-Das Ausgleichungsprogramm Java·Applied·Geodesy·3D (JAG3D) wird über [[https://github.com/loesler/applied-geodesy|github.com]] zum Download bereitgestellt. Neben dem aktuellen Release sind dort auch zurückliegende Versionen zu finden. Ferner wird der Quellcode von JAG3D im bereitgestellten Repository verwaltet.
+Das Ausgleichungsprogramm Java·Applied·Geodesy·3D (JAG3D) wird über [[https://github.com/applied-geodesy/jag3d|github.com]] zum Download bereitgestellt. Neben dem aktuellen Release sind dort auch zurückliegende Versionen zu finden. Ferner wird der Quellcode von JAG3D im bereitgestellten Repository verwaltet.
 ===== Lizenzbedingungen =====
@@ Zeile 16: / Zeile 16: @@
 ===== Systemvorraussetzungen =====
-JAG3D benötigt ca. 300 MB freien Speicherplatz und die Standardedition der Java-Laufzeitumgebung (JRE – Java Runtime Environment) ab Version 16. Diese steht für die Betriebssysteme Windows, Mac OS X, Linux und Solaris kostenlos unter [[http://java.oracle.com|java.oracle.com]] zur Verfügung. Das graphische Userinterface basiert auf der JavaFX 2.0 Technologie. Um zu prüfen, ob eine Laufzeitumgebung bereits auf dem System vorhanden ist und sich im Suchpfad befindet, kann plattformübergreifend über die Eingabekonsole (Shell) die Version abgefragt werden.
+JAG3D benötigt ca. 300 MB freien Speicherplatz und die Standardedition der Java-Laufzeitumgebung (JRE – Java Runtime Environment) ab Version 21. Diese steht für die Betriebssysteme Windows, Mac OS X, Linux und Solaris kostenlos unter [[http://java.oracle.com|java.oracle.com]] zur Verfügung. Das graphische Userinterface basiert auf der JavaFX 2.0 Technologie. Um zu prüfen, ob eine Laufzeitumgebung bereits auf dem System vorhanden ist und sich im Suchpfad befindet, kann plattformübergreifend über die Eingabekonsole (Shell) die Version abgefragt werden.
 <code bash>java -version</code>
@@ Zeile 63: / Zeile 63: @@
 Unter Windows ist die Endung ''jar'' häufig mit einem Packprogramm verknüpft. Ein Doppelklick auf die Anwendung wird somit nicht an die JRE durchgereicht, sondern öffnet den Packer, der den Inhalt der ''jar'' auflistet. Für Windowsnutzer ist daher eine mit [[http://launch4j.sourceforge.net|Launch4j]] erzeugte ''exe''-Datei im Downloadpaket enthalten, die wie gewohnt durch einen Doppelklick gestartet werden kann.
-Über die ''jag3d.l4j.ini''-Datei können zusätzliche Argumente an die virtuelle Maschine (JVM) übergeben werden. Hierunter zählen u.a. Sprachfestlegung und Speicherreservierung der Applikation. Die Argumente sind zeilenweise in der Datei zu hinterlegen. Eine Liste mit zulässigen Argumenten findet sich [[https://docs.oracle.com/javase/7/docs/technotes/tools/windows/java.html|hier]]. Die folgende Datei zeigt exemplarisch mögliche Einstellungen zum Anzeigen eines Splash-Screens (''-splash''), zur Festlegung der bevorzugten Oberflächensprache (''-Duser.language'') und zur Speicherreservierung (''-Xms'' bzw. ''-Xmx'').
+Über die ''jag3d.l4j.ini''-Datei können zusätzliche Argumente an die virtuelle Maschine (JVM) übergeben werden. Hierunter zählen u.a. Sprachfestlegung und Speicherreservierung der Applikation. Die Argumente sind zeilenweise in der Datei zu hinterlegen. Eine Liste mit zulässigen Argumenten findet sich [[https://docs.oracle.com/en/java/javase/21/docs/specs/man/java.html|hier]]. Die folgende Datei zeigt exemplarisch mögliche Einstellungen zum Anzeigen eines Splash-Screens (''-splash''), zur Festlegung der bevorzugten Oberflächensprache (''-Duser.language'') und zur Speicherreservierung (''-Xms'' bzw. ''-Xmx'').
 <file ini jag3d.l4j.ini>-splash:resources/splash/JAG3D_255x255_splash.gif
@@ Zeile 73: / Zeile 73: @@
 <code bash>java -jar -Xms200m -Xmx500m jag3d.jar</code>
+===== Platform Module System =====
+Mit Java 8 wurde das //Platform Module System// eingeführt, sodass der o.g. Aufruf die Warnung
+<code cmd>WARNUNG: Unsupported JavaFX configuration: classes were loaded from 'unnamed module @66ab0333'</code>
+hervorruft. Um diese Warnung zu unterbinden, ist neben dem ''module-path'', der den Pfad zu den abhängigen Modulen (Bibliotheken) spezifiziert, das ''module'' JAG3D explizit anzugeben. Hierbei ist zu beachten, dass das Trennzeichen zwischen den Modulen betriebssystemabhängig ist. Während es unter Windows ein Semikolon ist, ist es unter Linux und macOS ein Doppelpunkt. Details hierzu sind der Java-[[https://docs.oracle.com/en/java/javase/21/docs/specs/man/java.html|Hilfe]] zu entnehmen:
+<code bash>--module-path <module path>...
+              A : separated list of directories, each directory
+              is a directory of modules.</code>
+Entsprechend des //Platform Module System// von Java lautet der modifizierte Aufruf nun
+<file bash jag3d.sh>#!/bin/bash
+java -Xms200m -Xmx500m -jar --class-path "./resources" --module-path "jag3d.jar:./javafx/lib:./lib" --module org.applied_geodesy.jag3d/org.applied_geodesy.jag3d.ui.JAG3D jag3d.jar</file>
+der hier in einem ausführbaren Shell-Script für Linux hinterlegt ist.