New iOS SDL3 + GLES 3.0 Angle Metal backend (#2775)

Author: riccardobl

.github/workflows/j3o-scan.yml

@@ -34,7 +34,7 @@ jobs:
         uses: actions/setup-java@v5
         with:
           distribution: temurin
-          java-version: '17'
+          java-version: '25'
 
       - name: Scan J3O assets
         run: ./gradlew :jme3-desktop:scanJ3O --console=plain

.github/workflows/main.yml

@@ -69,7 +69,7 @@ jobs:
         uses: actions/setup-java@v5
         with:
           distribution: 'temurin'
-          java-version: '21'
+          java-version: '25'
       - name: Validate the Gradle wrapper
         uses: gradle/actions/wrapper-validation@v6.1.0
       - name: Run Checkstyle
@@ -96,7 +96,7 @@ jobs:
         uses: actions/setup-java@v5
         with:
           distribution: 'temurin'
-          java-version: '21'
+          java-version: '25'
       - name: Validate the Gradle wrapper
         uses: gradle/actions/wrapper-validation@v6.1.0
       - name: Run SpotBugs
@@ -120,6 +120,11 @@ jobs:
       contents: read
     steps:
       - uses: actions/checkout@v6
+      - name: Setup the java environment
+        uses: actions/setup-java@v5
+        with:
+          distribution: 'temurin'
+          java-version: '25'
       - name: Start xvfb
         run: |
           Xvfb :99 -ac -screen 0 1024x768x16 &
@@ -150,45 +155,6 @@ jobs:
             **/build/changed-images/**
             **/build/test-results/**
 
-  # Build iOS natives
-  BuildIosNatives:
-    name: Build natives for iOS
-    runs-on: macOS-14
-
-    steps:
-      - name: Check default JAVAs 
-        run: echo $JAVA_HOME --- $JAVA_HOME_8_X64 --- $JAVA_HOME_11_X64 --- $JAVA_HOME_17_X64 --- $JAVA_HOME_21_X64 ---
-
-      - name: Setup the java environment
-        uses: actions/setup-java@v5
-        with:
-          distribution: 'temurin'
-          java-version: '17'
-
-      - name: Setup the XCode version to 15.1.0 
-        uses: maxim-lobanov/setup-xcode@ed7a3b1fda3918c0306d1b724322adc0b8cc0a90 # v1.7.0
-        with:
-          xcode-version: '15.1.0'
-
-      - name: Clone the repo
-        uses: actions/checkout@v6
-        with:
-          fetch-depth: 1
-
-      - name: Validate the Gradle wrapper
-        uses: gradle/actions/wrapper-validation@v6.1.0
-
-      - name: Build
-        run: |
-          ./gradlew -PuseCommitHashAsVersionName=true --no-daemon -PbuildNativeProjects=true \
-          :jme3-ios-native:build
-
-      - name: Upload natives
-        uses: actions/upload-artifact@v7.0.1
-        with:
-          name: ios-natives
-          path: jme3-ios-native/template/META-INF/robovm/ios/libs/jme3-ios-native.xcframework
-
   # Build the natives on android
   BuildAndroidNatives:
     name: Build natives for android
@@ -202,11 +168,11 @@ jobs:
         with:
           fetch-depth: 1
 
-      - name: Setup Java 17
+      - name: Setup Java 25
         uses: actions/setup-java@v5
         with:
           distribution: temurin
-          java-version: '17'
+          java-version: '25'
 
       - name: Check java version
         run: java -version
@@ -234,7 +200,7 @@ jobs:
 
   # Build the engine, we only deploy from ubuntu-latest jdk25
   BuildJMonkey:
-    needs: [BuildAndroidNatives, BuildIosNatives]
+    needs: [BuildAndroidNatives]
     name: Build on ${{ matrix.osName }} jdk${{ matrix.jdk }}
     runs-on: ${{ matrix.os }}
     strategy:
@@ -259,18 +225,18 @@ jobs:
         with:
           fetch-depth: 1
 
+      - name: Setup the java environment
+        uses: actions/setup-java@v5
+        with:
+          distribution: 'temurin'
+          java-version: ${{ matrix.jdk }}
+
       - name: Download natives for android
         uses: actions/download-artifact@v8.0.1
         with:
           name: android-natives
           path: build/native
 
-      - name: Download natives for iOS
-        uses: actions/download-artifact@v8.0.1
-        with:
-          name: ios-natives
-          path: jme3-ios-native/template/META-INF/robovm/ios/libs/jme3-ios-native.xcframework
-
       - name: Validate the Gradle wrapper
         uses: gradle/actions/wrapper-validation@v6.1.0
       - name: Build Engine
@@ -453,25 +419,19 @@ jobs:
         with:
           fetch-depth: 1
 
-      # Setup jdk 21 used for building Maven-style artifacts
+      # Setup jdk 25 used for building Maven-style artifacts
       - name: Setup the java environment
         uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
         with:
           distribution: 'temurin'
-          java-version: '21'
+          java-version: '25'
 
       - name: Download natives for android
         uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
           name: android-natives
           path: build/native
 
-      - name: Download natives for iOS
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
-        with:
-          name: ios-natives
-          path: jme3-ios-native/template/META-INF/robovm/ios/libs/jme3-ios-native.xcframework
-
       - name: Rebuild the maven artifacts and upload them to Sonatype's maven-snapshots repo
         run: |
           if [ "${{ secrets.CENTRAL_PASSWORD }}" = "" ];
@@ -502,12 +462,12 @@ jobs:
         with:
           fetch-depth: 1
 
-      # Setup jdk 21 used for building Sonatype artifacts
+      # Setup jdk 25 used for building Sonatype artifacts
       - name: Setup the java environment
         uses: actions/setup-java@v5
         with:
           distribution: 'temurin'
-          java-version: '21'
+          java-version: '25'
 
       # Download all the stuff...
       - name: Download maven artifacts
@@ -528,12 +488,6 @@ jobs:
           name: android-natives
           path: build/native
 
-      - name: Download natives for iOS
-        uses: actions/download-artifact@v8.0.1
-        with:
-          name: ios-natives
-          path: jme3-ios-native/template/META-INF/robovm/ios/libs/jme3-ios-native.xcframework
-
       - name: Rebuild the maven artifacts and upload them to Sonatype's Central Publisher Portal
         run: |
           if [ "${{ secrets.CENTRAL_PASSWORD }}" = "" ];

gradle/libs.versions.toml

@@ -6,6 +6,7 @@ checkstyle = "13.3.0"
 jacoco = "0.8.12"
 lwjgl3 = "3.4.1"
 angle = "2026-05-09"
+libjglios = "0.2"
 saferalloc = "0.0.8"
 nifty = "1.4.3"
 spotbugs = "4.9.8"
@@ -56,6 +57,12 @@ vecmath = "javax.vecmath:vecmath:1.5.2"
 stb-image = "org.ngengine:stb-image:2.30.5"
 imagewebp = "org.ngengine:image-webp-decoder:1.3.0"
 angle = { module = "org.ngengine:angle-natives", version.ref = "angle" }
+libjglios-angle-ios = { module = "org.ngengine:libjglios-angle-ios", version.ref = "libjglios" }
+libjglios-core-ios = { module = "org.ngengine:libjglios-core-ios", version.ref = "libjglios" }
+libjglios-gles-ios = { module = "org.ngengine:libjglios-gles-ios", version.ref = "libjglios" }
+libjglios-gradle-plugin = { module = "org.ngengine:libjglios-gradle-plugin", version.ref = "libjglios" }
+libjglios-openal-ios = { module = "org.ngengine:libjglios-openal-ios", version.ref = "libjglios" }
+libjglios-sdl3-ios = { module = "org.ngengine:libjglios-sdl3-ios", version.ref = "libjglios" }
 saferalloc = { module = "org.ngengine:saferalloc", version.ref = "saferalloc" }
 saferalloc-natives-linux-x8664 = { module = "org.ngengine:saferalloc-natives-linux-x86_64", version.ref = "saferalloc" }
 saferalloc-natives-linux-aarch64 = { module = "org.ngengine:saferalloc-natives-linux-aarch64", version.ref = "saferalloc" }

jme3-core/src/main/java/com/jme3/renderer/Caps.java

@@ -427,6 +427,11 @@ public enum Caps {
      */
     DepthTexture,
 
+    /**
+     * Supports hardware depth texture comparison for shadow maps.
+     */
+    TextureShadowCompare,
+
     /**
      * Supports 32-bit index buffers.
      */

jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java

@@ -453,6 +453,10 @@ private void loadCapabilitiesCommon() {
             caps.add(Caps.DepthTexture);
         }
 
+        if (gl2 != null || caps.contains(Caps.OpenGLES30)) {
+            caps.add(Caps.TextureShadowCompare);
+        }
+
         if (caps.contains(Caps.OpenGL20) || caps.contains(Caps.OpenGLES30) || caps.contains(Caps.WebGL)
                 || hasExtension("GL_OES_depth24")) {
             caps.add(Caps.Depth24);
@@ -2674,7 +2678,7 @@ && isMipmapGenerationSupported(image.getFormat(),
         }
 
         ShadowCompareMode texCompareMode = tex.getShadowCompareMode();
-        if ( (gl2 != null || caps.contains(Caps.OpenGLES30)) && curState.shadowCompareMode != texCompareMode) {
+        if (caps.contains(Caps.TextureShadowCompare) && curState.shadowCompareMode != texCompareMode) {
             bindTextureAndUnit(target, image, unit);
             if (texCompareMode != ShadowCompareMode.Off) {
                 gl.glTexParameteri(target, GL2.GL_TEXTURE_COMPARE_MODE, GL2.GL_COMPARE_REF_TO_TEXTURE);

jme3-core/src/main/java/com/jme3/util/MaterialDebugAppState.java

@@ -377,16 +377,23 @@ public void init() {
                     file = new File(url.getFile());
                     fileLastM = file.lastModified();
 
-                } catch (NoSuchFieldException
-                        | SecurityException
+                } catch (NoSuchFieldException ex) {
+                    Logger.getLogger(MaterialDebugAppState.class.getName()).log(Level.FINE,
+                            "Material hot reload disabled for {0}; asset URL is not reflectively available.",
+                            fileName);
+                } catch (SecurityException
                         | IllegalArgumentException
                         | IllegalAccessException ex) {
-                    Logger.getLogger(MaterialDebugAppState.class.getName()).log(Level.SEVERE, null, ex);
+                    Logger.getLogger(MaterialDebugAppState.class.getName()).log(Level.FINE,
+                            "Material hot reload disabled for " + fileName, ex);
                 }
             }
         }
 
         public boolean shouldFire() {
+            if (file == null || fileLastM == null) {
+                return false;
+            }
             if (file.lastModified() != fileLastM) {
                 fileLastM = file.lastModified();
                 return true;