Run CI Javadocs with Java 25 (#4409)

Author: shai-almog

.github/workflows/pr.yml

@@ -253,6 +253,13 @@ jobs:
         if: matrix.java-version == 8
         run: ant -noinput -buildfile CodenameOne/build.xml weeklyLibUpdate
 
+      - name: Set up Java 25 for JavaDocs
+        if: matrix.java-version == 8
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '25'
+
       - name: Build JavaDocs
         if: matrix.java-version == 8
         run: |
@@ -263,11 +270,40 @@ jobs:
           mkdir -p dist/javadoc
           # Skip JavaDocSourceEmbed due to gist access issues in CI
           cp -r src/* build/tempJavaSources/
-          find build/tempJavaSources ../Ports/CLDC11/src -name "*.java" | /usr/bin/grep -v /impl/ | /usr/bin/xargs javadoc --allow-script-in-comments -protected -d dist/javadoc -windowtitle "Codename One API" || true
+          # Provide a minimal ImplementationFactory stub for Javadoc type resolution on JDK 25.
+          cat > build/tempJavaSources/com/codename1/impl/ImplementationFactory.java <<'EOF'
+          package com.codename1.impl;
+
+          public class ImplementationFactory {
+              public static ImplementationFactory getInstance() {
+                  return null;
+              }
+
+              public Object createImplementation() {
+                  return null;
+              }
+          }
+          EOF
+          # Suppress doclint noise on modern JDKs (e.g., Java 25) while keeping output consistent.
+          # Exclude CLDC11 java.* stubs to avoid module conflicts on modern JDKs.
+          find build/tempJavaSources ../Ports/CLDC11/src -name "*.java" -not -path "../Ports/CLDC11/src/java/*" | /usr/bin/xargs javadoc --allow-script-in-comments --release 8 -exclude com.codename1.impl -Xdoclint:none -quiet -protected -d dist/javadoc -windowtitle "Codename One API" || true
           cd dist/javadoc
           zip -r ../../javadocs.zip *
           cd ..
 
+      - name: Restore Java 8 after JavaDocs
+        if: matrix.java-version == 8
+        run: |
+          echo "JAVA_HOME=${JAVA_HOME_8}" >> $GITHUB_ENV
+          echo "${JAVA_HOME_8}/bin" >> $GITHUB_PATH
+
+      - name: Upload JavaDocs artifact
+        if: matrix.java-version == 8
+        uses: actions/upload-artifact@v4
+        with:
+          name: CodenameOne-javadocs
+          path: CodenameOne/javadocs.zip
+
       - name: Build iOS Port
         run: |
           ANT_OPTS_ARGS=""
@@ -339,4 +375,3 @@ jobs:
           name: JavaSE.jar
           path: Ports/JavaSE/dist/JavaSE.jar
 
-