Handle macOS ARM JDK 8 and skip Android javadocs

Author: shai-almog

BUILDING.md

@@ -1,6 +1,6 @@
 # Building Codename One
 
-This guide explains how to build Codename One and its Android and iOS ports locally with Maven.
+This guide provides reproducible steps to build Codename One locally with Maven, including its Android and iOS ports.
 
 ## Prerequisites
 
@@ -9,7 +9,8 @@ This guide explains how to build Codename One and its Android and iOS ports loca
 - **Apache Maven 3.6+**
 - macOS with Xcode (required only for the iOS port)
 
-The helper scripts in the `scripts/` directory download these dependencies when they are not already installed.
+The helper scripts in the `scripts/` directory download these dependencies when they are not already installed. On Apple Silicon
+macOS machines, the scripts download the Intel JDK 8 and run it via Rosetta because an ARM build of JDK 8 is unavailable.
 
 ### Installing JDKs on Linux
 
@@ -44,7 +45,8 @@ The script runs `mvn install` in `maven/`, installs `cn1-maven-archetypes`, and
 
 ## Building the Android port
 
-The Android port uses JDK 17 for compilation while Maven runs with JDK 8. Run the build script:
+The Android port uses JDK 17 for compilation while Maven runs with JDK 8. Javadoc generation is skipped to avoid known Maven
+report issues. Run the build script:
 
 ```bash
 ./scripts/build-android-port.sh -DskipTests

scripts/build-android-port.sh

@@ -40,4 +40,4 @@ if [ ! -f "$BUILD_CLIENT" ]; then
   fi
 fi
 
-"$MAVEN_HOME/bin/mvn" -q -f maven/pom.xml -pl android -am clean install "$@"
+"$MAVEN_HOME/bin/mvn" -q -f maven/pom.xml -pl android -am -Dmaven.javadoc.skip=true clean install "$@"

scripts/setup-workspace.sh

@@ -21,10 +21,17 @@ case "$arch_name" in
   x86_64|amd64) arch="x64" ;;
   arm64|aarch64) arch="aarch64" ;;
   *) echo "Unsupported architecture: $arch_name" >&2; exit 1 ;;
-  esac
+esac
+
+# JDK 8 is not available for Apple Silicon. Use the Intel build when running on macOS ARM.
+jdk8_arch="$arch"
+jdk17_arch="$arch"
+if [ "$os" = "mac" ] && [ "$arch" = "aarch64" ]; then
+  jdk8_arch="x64"
+fi
 
-JDK8_URL="https://github.com/adoptium/temurin8-binaries/releases/download/jdk8u462-b08/OpenJDK8U-jdk_${arch}_${os}_hotspot_8u462b08.tar.gz"
-JDK17_URL="https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.16%2B8/OpenJDK17U-jdk_${arch}_${os}_hotspot_17.0.16_8.tar.gz"
+JDK8_URL="https://github.com/adoptium/temurin8-binaries/releases/download/jdk8u462-b08/OpenJDK8U-jdk_${jdk8_arch}_${os}_hotspot_8u462b08.tar.gz"
+JDK17_URL="https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.16%2B8/OpenJDK17U-jdk_${jdk17_arch}_${os}_hotspot_17.0.16_8.tar.gz"
 MAVEN_URL="https://archive.apache.org/dist/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz"
 
 install_jdk() {