Use JDK 8 for core builds

Author: shai-almog

BUILDING.md

@@ -1,10 +1,10 @@
 # Building Codename One
 
-This guide explains how to build Codename One from source with Maven. It covers the core framework and the Android and iOS ports.
+This guide explains how to build Codename One from source using Maven. It provides reproducible steps to compile the core framework and its Android and iOS ports.
 
 ## Prerequisites
 
-- **JDK 11**
+- **JDK 8**
 - **JDK 17** for building the Android port
 - **Apache Maven 3.6+**
 - macOS with Xcode (required only for the iOS port)
@@ -16,10 +16,10 @@ The helper scripts in the `scripts/` directory download these dependencies when
 Download binaries from [Adoptium](https://adoptium.net):
 
 ```bash
-# JDK 11 (Linux x64; adjust `_x64_linux_` for your platform)
-curl -L -o temurin11.tar.gz https://github.com/adoptium/temurin11-binaries/releases/download/jdk-11.0.28%2B6/OpenJDK11U-jdk_x64_linux_hotspot_11.0.28_6.tar.gz
-tar xf temurin11.tar.gz
-export JAVA_HOME=$PWD/jdk-11.0.28+6
+# JDK 8 (Linux x64; adjust `_x64_linux_` for your platform)
+curl -L -o temurin8.tar.gz https://github.com/adoptium/temurin8-binaries/releases/download/jdk8u462-b08/OpenJDK8U-jdk_x64_linux_hotspot_8u462b08.tar.gz
+tar xf temurin8.tar.gz
+export JAVA_HOME=$PWD/jdk8u462-b08
 
 # JDK 17 (Linux x64; adjust `_x64_linux_` for your platform)
 curl -L -o temurin17.tar.gz https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.16%2B8/OpenJDK17U-jdk_x64_linux_hotspot_17.0.16_8.tar.gz
@@ -31,7 +31,7 @@ export PATH="$JAVA_HOME/bin:$PATH"
 
 ## Preparing the workspace
 
-Clone the repository and run the setup script to download JDK 11 and JDK 17, install Maven, build the core modules, and install the Maven archetypes. This step must be performed before building any ports.
+Clone the repository and run the setup script to download JDK 8 and JDK 17, install Maven, build the core modules, and install the Maven archetypes. This step must be performed before building any ports.
 
 ```bash
 git clone https://github.com/codenameone/CodenameOne
@@ -44,7 +44,7 @@ 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 11. Javadoc generation is skipped to avoid known Maven report issues. 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
@@ -64,9 +64,9 @@ Artifacts are produced in `maven/ios/target`.
 
 ## Convenience scripts
 
-- `setup-workspace.sh` – installs Maven, downloads JDK 11 and JDK 17, builds the core modules, installs Maven archetypes, provisions the Codename One build client, and writes `tools/env.sh`.
-- `build-android-port.sh` – builds the Android port using JDK 11 for Maven and JDK 17 for compilation.
-- `build-ios-port.sh` – builds the iOS port on macOS with JDK 11.
+- `setup-workspace.sh` – installs Maven, downloads JDK 8 and JDK 17, builds the core modules, installs Maven archetypes, provisions the Codename One build client, and writes `tools/env.sh`.
+- `build-android-port.sh` – builds the Android port using JDK 8 for Maven and JDK 17 for compilation.
+- `build-ios-port.sh` – builds the iOS port on macOS with JDK 8.
 
 ## Further reading
 

scripts/build-android-port.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Build Codename One Android port using JDK 11 for Maven and JDK 17 for compilation
+# Build Codename One Android port using JDK 8 for Maven and JDK 17 for compilation
 set -euo pipefail
 ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 cd "$ROOT"
@@ -11,12 +11,12 @@ else
   source "$ROOT/tools/env.sh"
 fi
 
-if ! "${JAVA_HOME:-}/bin/java" -version 2>&1 | grep -q '11\.0'; then
+if ! "${JAVA_HOME:-}/bin/java" -version 2>&1 | grep -q '1\.8\.0'; then
   ./scripts/setup-workspace.sh -q -DskipTests
   source "$ROOT/tools/env.sh"
 fi
-if ! "${JAVA_HOME:-}/bin/java" -version 2>&1 | grep -q '11\.0'; then
-  echo "Failed to provision JDK 11" >&2
+if ! "${JAVA_HOME:-}/bin/java" -version 2>&1 | grep -q '1\.8\.0'; then
+  echo "Failed to provision JDK 8" >&2
   exit 1
 fi
 if ! "${JAVA_HOME_17:-}/bin/java" -version 2>&1 | grep -q '17\.0'; then

scripts/build-ios-port.sh

@@ -17,12 +17,12 @@ else
   ./scripts/setup-workspace.sh -q -DskipTests
   source "$ROOT/tools/env.sh"
 fi
-if ! "${JAVA_HOME:-}/bin/java" -version 2>&1 | grep -q '11\.0'; then
+if ! "${JAVA_HOME:-}/bin/java" -version 2>&1 | grep -q '1\.8\.0'; then
   ./scripts/setup-workspace.sh -q -DskipTests
   source "$ROOT/tools/env.sh"
 fi
-if ! "${JAVA_HOME:-}/bin/java" -version 2>&1 | grep -q '11\.0'; then
-  echo "Failed to provision JDK 11" >&2
+if ! "${JAVA_HOME:-}/bin/java" -version 2>&1 | grep -q '1\.8\.0'; then
+  echo "Failed to provision JDK 8" >&2
   exit 1
 fi
 export PATH="$JAVA_HOME/bin:$MAVEN_HOME/bin:$PATH"

scripts/setup-workspace.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 ###
-# Prepare Codename One workspace by installing Maven, provisioning JDK 11 and JDK 17,
+# Prepare Codename One workspace by installing Maven, provisioning JDK 8 and JDK 17,
 # building core modules, and installing Maven archetypes.
 ###
 set -euo pipefail
@@ -32,7 +32,11 @@ case "$arch_name" in
 esac
 
 # Determine platform-specific JDK download URLs
-JDK11_URL="https://github.com/adoptium/temurin11-binaries/releases/download/jdk-11.0.28%2B6/OpenJDK11U-jdk_${arch}_${os}_hotspot_11.0.28_6.tar.gz"
+arch_jdk8="$arch"
+if [ "$os" = "mac" ] && [ "$arch" = "aarch64" ]; then
+  arch_jdk8="x64"
+fi
+JDK8_URL="https://github.com/adoptium/temurin8-binaries/releases/download/jdk8u462-b08/OpenJDK8U-jdk_${arch_jdk8}_${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"
 MAVEN_URL="https://archive.apache.org/dist/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz"
 
@@ -52,12 +56,12 @@ install_jdk() {
   eval "$dest_var=\"$home\""
 }
 
-log "Ensuring JDK 11 is available"
-if [ ! -x "${JAVA_HOME:-}/bin/java" ] || ! "${JAVA_HOME:-}/bin/java" -version 2>&1 | grep -q '11\.0'; then
-  log "Provisioning JDK 11 (this may take a while)..."
-  install_jdk "$JDK11_URL" JAVA_HOME
+log "Ensuring JDK 8 is available"
+if [ ! -x "${JAVA_HOME:-}/bin/java" ] || ! "${JAVA_HOME:-}/bin/java" -version 2>&1 | grep -q '1\.8\.0'; then
+  log "Provisioning JDK 8 (this may take a while)..."
+  install_jdk "$JDK8_URL" JAVA_HOME
 else
-  log "Using existing JDK 11 at $JAVA_HOME"
+  log "Using existing JDK 8 at $JAVA_HOME"
 fi
 
 log "Ensuring JDK 17 is available"
@@ -90,7 +94,7 @@ ENV
 
 source "$TOOLS/env.sh"
 
-log "JDK 11 version:"; "$JAVA_HOME/bin/java" -version
+log "JDK 8 version:"; "$JAVA_HOME/bin/java" -version
 log "JDK 17 version:"; "$JAVA_HOME_17/bin/java" -version
 log "Maven version:"; "$MAVEN_HOME/bin/mvn" -version