Subject: [PATCH] FIX: UnsatisfiedLinkError in libjawt.so:

SUNWprivate_1.1 not
 found

**Defect Category**
- broken external dependency

**Introduced when**
- We suspect jogamp.org/9fb1e46e43900ec9b2f9c9af1fc8984e101c8811 [1]

**Root Cause**
- JAWTUtil's static-init loads libawt.so while in headless mode [1, 2].

**Consequences** (effect <- cause .. <- root cause)
- Applications in workspace.examples.* won't start on Linux/OpenJDK
  - Load-Time error on Linux/OpenJDK showing the following symptom
    (local paths into build cache shortnened with "..."):
    > java.lang.UnsatisfiedLinkError:
    > .../natives/linux-amd64/libnativewindow_awt.so:
    >    /usr/lib/jvm/java-13-oracle/lib/libjawt.so:
    >      version `SUNWprivate_1.1' not found
    >      (required by .../natives/linux-amd64/libnativewindow_awt.so)
    - JAWTUtil's static-init loads libawt.so while in headless mode [2].

**Affected Versions**
- 2.3.2 <= jogl < 2.4.0

**Affected Environment (at least)**
- OS: Fedora Linux 39 (Workstation Edt.)
- Graphics: xorg-x11-drv-nouveau.x86_64 1:1.0.17-6.fc39
- Window Manager: Wayland
- JVM: Java-17-openjdk-headless.x86_64 1:17.0.13.0.11-3.fc39

**Reproducer** (in affected environment)
1. Clone repo and checkout previous commit.
2. In Eclipse IDE, import project as existing Maven project.
3. Run "Maven Install".
4. Open e.g. src/main/java/workspace/examples/HelloSceneObject.java.
5. Run as Java Application.

**Proposed Fix**
- The defect is introduced in [1] and fixed since [2] available since
  jogl>=2.4.0. Upgrading to a newer version of JOGL is found to indeed
  fixing the problem. Hence we:
  - bump JoGL to 2.5.0 and transitively...
  - bump Processing to 4.3.1 to match requirements.
- Note: JoGL 2.4.0 and newer is only available via the project's own
  distribution channel which is why we add its artifact registry to to
  the project definition.

**Confirmation of the fix**
1. checkout this commit
2. proceed with step 2) in Sect. "Reproducer"

**Kudos**
- Kudos to the community [3] for pointing us to the solution.

**References**
[1] https://jogamp.org/cgit/jogl.git/commit/
    ?h=v2.3.2
    &id=9fb1e46e43900ec9b2f9c9af1fc8984e101c8811
[2] https://jogamp.org/cgit/jogl.git/commit/
    ?h=v2.4.0
    &id=ecbf9742f5a4ce100388083babec25d098633021
[3] https://forum.jogamp.org/
  Oracle-Java-13-Linux-version-SUNWprivate-1-1-not-found-td4040172.html

Author: ArtifactForms

pom.xml

@@ -25,6 +25,13 @@
 			</plugin>
 		</plugins>
 	</build>
+	<repositories>
+		<repository>
+			<name>JoGL Distrib</name>
+			<id>org.jogamp</id>
+			<url>https://www.jogamp.org/deployment/maven/</url>
+		</repository>
+	</repositories>
 	<distributionManagement>
 		<repository>
 			<id>github</id>
@@ -42,17 +49,17 @@
 		<dependency>
 			<groupId>org.processing</groupId>
 			<artifactId>core</artifactId>
-			<version>3.3.7</version>
+			<version>4.3.1</version>
 		</dependency>
 		<dependency>
 			<groupId>org.jogamp.gluegen</groupId>
 			<artifactId>gluegen-rt-main</artifactId>
-			<version>2.3.2</version>
+			<version>2.5.0</version>
 		</dependency>
 		<dependency>
 			<groupId>org.jogamp.jogl</groupId>
 			<artifactId>jogl-all-main</artifactId>
-			<version>2.3.2</version>
+			<version>2.5.0</version>
 		</dependency>
 		<dependency>
 			<groupId>org.junit.platform</groupId>