Run classic Android applications as Codename One applications

.github/workflows/android-compat.yml

@@ -0,0 +1,103 @@
+name: Android compatibility
+
+# Classic Android applications built as Codename One applications: the resource
+# compiler (maven/android-res-compiler), the android.* runtime
+# (maven/android-compat) and the build steps that compile, relocate and package
+# them (build-engine, the Maven and Gradle plugins, the archetype profile).
+#
+#   unit tests                    the compiler's encoding and qualifier rules,
+#                                 the runtime's table reader, the remapper and
+#                                 the project importer
+#   android-compat-test.sh        every sample under scripts/android-compat-samples
+#                                 imported unmodified, built by Maven and Gradle,
+#                                 checked for unrelocated android.* references,
+#                                 and staged for iOS, Android, JavaScript and the
+#                                 desktop with identical uploads from both tools
+on:
+  pull_request:
+    branches: [ master ]
+    paths:
+      - 'maven/android-compat/**'
+      - 'maven/android-res-compiler/**'
+      - 'maven/build-engine/**'
+      - 'maven/codenameone-maven-plugin/**'
+      - 'maven/codenameone-gradle-plugin/**'
+      - 'maven/project-model/**'
+      - 'maven/cn1app-archetype/**'
+      - 'maven/pom.xml'
+      - 'maven/integration-tests/android-compat-test.sh'
+      - 'maven/integration-tests/android-gradle-incremental-test.sh'
+      - 'maven/integration-tests/inc/**'
+      - 'scripts/android-compat-samples/**'
+      - '.github/workflows/android-compat.yml'
+  push:
+    branches: [ master ]
+    paths:
+      - 'maven/android-compat/**'
+      - 'maven/android-res-compiler/**'
+      - 'maven/build-engine/**'
+      - 'maven/codenameone-maven-plugin/**'
+      - 'maven/codenameone-gradle-plugin/**'
+      - 'maven/project-model/**'
+      - 'maven/cn1app-archetype/**'
+      - 'maven/pom.xml'
+      - 'maven/integration-tests/android-compat-test.sh'
+      - 'maven/integration-tests/android-gradle-incremental-test.sh'
+      - 'maven/integration-tests/inc/**'
+      - 'scripts/android-compat-samples/**'
+      - '.github/workflows/android-compat.yml'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  android-compat:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 60
+    env:
+      CN1_GRADLE_REQUIRED: '1'
+    steps:
+      - uses: actions/checkout@v6
+      # Installed FIRST so the JDK 8 below is the one JAVA_HOME names.
+      - name: Set up JDK 17 for Gradle
+        uses: actions/setup-java@v5
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+      - run: echo "GRADLE_JAVA_HOME=$JAVA_HOME" >> $GITHUB_ENV
+      - name: Set up JDK 8
+        uses: actions/setup-java@v5
+        with:
+          java-version: '8'
+          distribution: 'temurin'
+          cache: 'maven'
+      # xvfb for the CSS compiler, which opens an AWT frame.
+      - name: Install xvfb
+        run: bash scripts/ci/apt-get-install.sh xvfb
+      - name: Build Codename One Maven artifacts (includes archetypes and both plugins)
+        env:
+          RETRY_ONLY_MATCHING: transient
+          RETRY_ATTEMPTS: '5'
+          RETRY_DELAY_SECONDS: '60'
+        run: |
+          cd maven
+          bash ../scripts/ci/retry.sh xvfb-run -a mvn install -Plocal-dev-javase -DskipTests -Darchetype.test.skip=true -Dmaven.javadoc.skip=true
+      - name: Unit tests
+        working-directory: maven
+        run: xvfb-run -a mvn -B -Plocal-dev-javase -pl android-res-compiler,android-compat,build-engine test
+      - name: Refresh archetype catalog
+        run: |
+          cd maven
+          xvfb-run -a mvn archetype:update-local-catalog -Plocal-dev-javase
+          xvfb-run -a mvn archetype:crawl -Plocal-dev-javase
+      - name: Android samples, imported and built by Maven and Gradle
+        working-directory: maven/integration-tests
+        run: xvfb-run -a bash android-compat-test.sh
+      - name: Upload the test projects' logs
+        if: failure()
+        uses: actions/upload-artifact@v7
+        with:
+          name: android-compat-logs
+          path: maven/integration-tests/build/android-compat/**/*.log
+          if-no-files-found: ignore

.github/workflows/ios-packaging.yml

@@ -30,7 +30,8 @@ jobs:
     # sequence. On a cold runner all tests passed after 119m44s, leaving only
     # 16s of the old two-hour budget for artifact upload and cache saves. Keep
     # the individual step limits below and allow 30m of finalization headroom.
-    timeout-minutes: 150
+    # The hello app now also translates the Android compatibility gallery, its runtime and the Kotlin stdlib; 150 no longer covers the three builds.
+    timeout-minutes: 210
     # Exercises both CocoaPods and SPM in a single Xcode project. Catches
     # regressions in either dependency manager (each pathway runs end to end)
     # and additionally validates that they coexist correctly. Also turns on
@@ -163,7 +164,8 @@ jobs:
           ./scripts/run-ios-device-release-build.sh \
             "${{ steps.build_ios_app.outputs.workspace }}" \
             "${{ steps.build_ios_app.outputs.scheme }}"
-        timeout-minutes: 45
+        # A cold Release compile of the hello app (now with the Android compatibility gallery, its runtime and the Kotlin stdlib) took 42.5 of 45 minutes.
+        timeout-minutes: 70
 
       # The binary half of scripts-ios.yml's private-API gate. App Store Connect scans the
       # linked executable, so this reads what it would read: every import of the Release
@@ -219,7 +221,8 @@ jobs:
             "${{ steps.build_ios_app.outputs.scheme }}"
         # run-ios-ui-tests.sh has a 12-minute no-progress watchdog and a
         # bounded 35-minute suite cap; include native build/cleanup headroom.
-        timeout-minutes: 65
+        # The cold -O1 compile alone reached 52 minutes once the hello app gained the Android compatibility gallery, its runtime and the Kotlin stdlib.
+        timeout-minutes: 100
 
       - name: Run native iOS notification tests
         env:
@@ -247,8 +250,8 @@ jobs:
         # So the higher of the two, not either alone: the watch build is added work on top of the
         # rebuild, not a re-description of it. The real fix is to inject before the UI-smoke step
         # so this build is genuinely incremental; until then the budget has to cover the build it
-        # actually does.
-        timeout-minutes: 45
+        # actually does. The hello app's growth (the Android compatibility gallery, its runtime and the Kotlin stdlib) added roughly half again to that build.
+        timeout-minutes: 60
 
       - name: Upload packaging artifacts
         if: ${{ !cancelled() }}

.github/workflows/parparvm-tests.yml

@@ -177,7 +177,8 @@ jobs:
   vm-tests:
     runs-on: ubuntu-24.04
     # The full suite takes about an hour before the bounded GC benchmark arms.
-    # Leave time for both; each benchmark workload retains its own timeout.
+    # Android compatibility and Kotlin translation add time; leave room for
+    # both phases while each GC workload retains its own timeout.
     timeout-minutes: 120
     # The two database engines the backend speaks a wire protocol to.
     #

.github/workflows/pr.yml

@@ -40,6 +40,8 @@ on:
       - 'scripts/check-native-cpp-linkage.py'
       # Same: the builder define-toggle lint runs from this workflow and nowhere else.
       - 'scripts/check-builder-define-toggles.py'
+      - 'scripts/check-cast-semantics.sh'
+      - 'scripts/cast-semantics-baseline.txt'
       # The build hint gates are run from this workflow and nowhere else, and one
       # of them holds an empty baseline. Ignoring the whole directory meant a
       # change that breaks a gate, or that adds a line to the baseline, could
@@ -108,6 +110,8 @@ on:
       - 'scripts/check-native-cpp-linkage.py'
       # Same: the builder define-toggle lint runs from this workflow and nowhere else.
       - 'scripts/check-builder-define-toggles.py'
+      - 'scripts/check-cast-semantics.sh'
+      - 'scripts/cast-semantics-baseline.txt'
       # The build hint gates are run from this workflow and nowhere else, and one
       # of them holds an empty baseline. Ignoring the whole directory meant a
       # change that breaks a gate, or that adds a line to the baseline, could
@@ -387,7 +391,7 @@ jobs:
             -Dcn1.binaries="${CN1_BINARIES}" \
             -Pcompile-android \
             -DbackendAnalysis \
-            -pl android,ios,project-model,build-engine,codenameone-maven-plugin,codenameone-gradle-plugin,backend,backend-test,backend-parparvm,javac -am verify
+            -pl android,ios,project-model,build-engine,codenameone-maven-plugin,codenameone-gradle-plugin,backend,backend-test,backend-parparvm,javac,android-res-compiler,android-compat -am verify
       - name: Type-check the SQLCipher-backed database package
         if: ${{ matrix.java-version == 8 }}
         env:
@@ -602,7 +606,7 @@ jobs:
       - name: Generate static analysis HTML summaries
         if: ${{ !cancelled() && matrix.java-version == 8 }}
         env:
-          QUALITY_REPORT_TARGET_DIRS: maven/core-unittests/target:maven/android/target:maven/ios/target:vm/ByteCodeTranslator/target:maven/codenameone-maven-plugin/target:maven/build-engine/target:maven/project-model/target:maven/codenameone-gradle-plugin/target:maven/build-hint-catalog/target:maven/build-hint-tools/target:maven/backend/target:maven/backend-test/target:maven/backend-parparvm/target:maven/javac/target
+          QUALITY_REPORT_TARGET_DIRS: maven/core-unittests/target:maven/android/target:maven/ios/target:vm/ByteCodeTranslator/target:maven/codenameone-maven-plugin/target:maven/build-engine/target:maven/project-model/target:maven/codenameone-gradle-plugin/target:maven/build-hint-catalog/target:maven/build-hint-tools/target:maven/backend/target:maven/backend-test/target:maven/backend-parparvm/target:maven/javac/target:maven/android-res-compiler/target:maven/android-compat/target
           QUALITY_REPORT_SERVER_URL: ${{ github.server_url }}
           QUALITY_REPORT_REPOSITORY: ${{ github.repository }}
           QUALITY_REPORT_REF: ${{ github.event.pull_request.head.sha || github.sha }}
@@ -622,6 +626,8 @@ jobs:
             "bytecode-translator:vm/ByteCodeTranslator/target" \
             "maven-plugin:maven/codenameone-maven-plugin/target" \
             "build-engine:maven/build-engine/target" \
+            "android-res-compiler:maven/android-res-compiler/target" \
+            "android-compat:maven/android-compat/target" \
             "project-model:maven/project-model/target" \
             "gradle-plugin:maven/codenameone-gradle-plugin/target" \
             "backend:maven/backend/target" \
@@ -752,11 +758,11 @@ jobs:
       - name: Generate quality report summary
         if: ${{ !cancelled() && matrix.java-version == 8 }}
         env:
-          QUALITY_REPORT_TARGET_DIRS: maven/core-unittests/target:maven/android/target:maven/ios/target:vm/ByteCodeTranslator/target:maven/codenameone-maven-plugin/target:maven/build-engine/target:maven/project-model/target:maven/codenameone-gradle-plugin/target:maven/build-hint-catalog/target:maven/build-hint-tools/target:maven/backend/target:maven/backend-test/target:maven/backend-parparvm/target:maven/javac/target
+          QUALITY_REPORT_TARGET_DIRS: maven/core-unittests/target:maven/android/target:maven/ios/target:vm/ByteCodeTranslator/target:maven/codenameone-maven-plugin/target:maven/build-engine/target:maven/project-model/target:maven/codenameone-gradle-plugin/target:maven/build-hint-catalog/target:maven/build-hint-tools/target:maven/backend/target:maven/backend-test/target:maven/backend-parparvm/target:maven/javac/target:maven/android-res-compiler/target:maven/android-compat/target
           # Every project listed here must produce a SpotBugs report and that
           # report must be empty. A missing report fails the gate too, so a
           # SpotBugs run that silently stops running is not mistaken for clean.
-          QUALITY_REPORT_REQUIRED_SPOTBUGS: core-unittests:android:ios:ByteCodeTranslator:codenameone-maven-plugin:build-engine:project-model:codenameone-gradle-plugin:build-hint-catalog:build-hint-tools:backend:backend-test:javac
+          QUALITY_REPORT_REQUIRED_SPOTBUGS: core-unittests:android:ios:ByteCodeTranslator:codenameone-maven-plugin:build-engine:project-model:codenameone-gradle-plugin:build-hint-catalog:build-hint-tools:backend:backend-test:javac:android-res-compiler:android-compat
           # PMD and Checkstyle run on the core and on the backend runtime, and each
           # must produce its report: without one, the forbidden-rule gate below it
           # has nothing to read and passes.

.github/workflows/scripts-ios-native.yml

@@ -29,6 +29,7 @@ jobs:
     # Allow setup plus the separately bounded 30-minute generation and 45-minute
     # XCTest build/run steps. A 45-minute job cap canceled a progressing native
     # build after only 34 minutes of the XCTest step in run 37728629000.
+    # The hello app also translates the Android compatibility gallery and Kotlin stdlib.
     timeout-minutes: 90
     steps:
       - uses: actions/checkout@v6
@@ -134,7 +135,8 @@ jobs:
         # scheme carries an embedded watch app with a ParparVM translation of its own, and
         # xcodebuild builds that before it can run a single test -- 16 of the 25 minutes went on
         # compiling it. The packaging job already allows 65 for the same reason.
-        timeout-minutes: 45
+        # Still compiling at 36 minutes once the hello app gained the Android compatibility gallery, its runtime and the Kotlin stdlib.
+        timeout-minutes: 70
 
       - name: Upload native iOS artifacts
         if: ${{ !cancelled() }}

.github/workflows/scripts-ios.yml

@@ -159,7 +159,8 @@ jobs:
       pull-requests: write
       issues: write
     runs-on: macos-15
-    timeout-minutes: 75
+    # The hello suite now also compiles the Android compatibility gallery, its runtime and the Kotlin stdlib; 75 left no margin.
+    timeout-minutes: 95
     env:
       GITHUB_TOKEN: ${{ secrets.CN1SS_GH_TOKEN }}
       # The device runner reports logical test failures through CN1SS log
@@ -415,7 +416,7 @@ jobs:
             "${{ steps.build-ios-app.outputs.scheme }}"
         # Match the GL envelope; run-ios-ui-tests.sh still fails a stalled
         # DeviceRunner after 12 minutes without CN1SS progress.
-        timeout-minutes: 65
+        timeout-minutes: 80
 
       - name: Upload iOS Metal port status
         if: ${{ !cancelled() }}
@@ -545,7 +546,8 @@ jobs:
       pull-requests: write
       issues: write
     runs-on: xcode-27
-    timeout-minutes: 75
+    # The hello suite now also compiles the Android compatibility gallery, its runtime and the Kotlin stdlib; 75 left no margin.
+    timeout-minutes: 95
     env:
       GITHUB_TOKEN: ${{ secrets.CN1SS_GH_TOKEN }}
       # The device runner reports logical test failures through CN1SS log
@@ -831,7 +833,7 @@ jobs:
             "${{ steps.build-ios-app.outputs.scheme }}"
         # Match the GL envelope; run-ios-ui-tests.sh still fails a stalled
         # DeviceRunner after 12 minutes without CN1SS progress.
-        timeout-minutes: 65
+        timeout-minutes: 80
 
       # NO port-status upload here, deliberately. The published port report is
       # keyed on the port id `ios-metal`, and there is only one iOS port -- this

.github/workflows/scripts-javascript.yml

@@ -23,6 +23,10 @@ on:
       - 'scripts/run-javascript-lifecycle-tests.mjs'
       - 'scripts/test-javascript-surface-replay.mjs'
       - 'scripts/test-javascript-weak-refs.mjs'
+      - 'scripts/test-javascript-native-stub-bindings.mjs'
+      - 'scripts/ci/tests/cn1ss-async-sink-test.sh'
+      - 'scripts/ci/tests/Cn1ssAsyncSinkTest.java'
+      - 'scripts/fidelity-app/common/src/main/java/com/codenameone/fidelity/Cn1ssAsyncSink.java'
       - 'scripts/test-javascript-vault-bridge.mjs'
       - 'scripts/test-javascript-composited-rendering.mjs'
       - 'scripts/javascript/composited-app/**'
@@ -67,6 +71,10 @@ on:
       - 'scripts/run-javascript-lifecycle-tests.mjs'
       - 'scripts/test-javascript-surface-replay.mjs'
       - 'scripts/test-javascript-weak-refs.mjs'
+      - 'scripts/test-javascript-native-stub-bindings.mjs'
+      - 'scripts/ci/tests/cn1ss-async-sink-test.sh'
+      - 'scripts/ci/tests/Cn1ssAsyncSinkTest.java'
+      - 'scripts/fidelity-app/common/src/main/java/com/codenameone/fidelity/Cn1ssAsyncSink.java'
       - 'scripts/run-javascript-lifecycle-tests.sh'
       - 'scripts/verify-javascript-lens-parity.mjs'
       - 'scripts/build-javascript-port-hellocodenameone.sh'
@@ -177,6 +185,19 @@ jobs:
       - name: Weak reference guards
         run: node scripts/test-javascript-weak-refs.mjs
 
+      # A static interop factory (JSString.valueOf, Int32Array.create, ...) runs
+      # its Java body -- `return null;` -- unless port.js binds it; an unbound
+      # JSString.valueOf made every directory marker a delete.
+      - name: Interop stub bindings
+        run: node scripts/test-javascript-native-stub-bindings.mjs
+
+      # Plain JVM, no build, so it also runs ahead of the ParparVM build. The
+      # sink the Java-side captures ship through must redial after the test
+      # server sheds its idle socket (close 1006): latching "failed" on that
+      # close lost VideoIODecodedFrames with websocket-unavailable.
+      - name: CN1SS async sink reconnect
+        run: bash scripts/ci/tests/cn1ss-async-sink-test.sh
+
       - name: Cache codenameone-tools
         uses: actions/cache@v5
         with: