Kotlin Multiplatform: Compose code as a Codename One app

.github/ci/apple-checks.json

@@ -48,6 +48,7 @@
       "scripts/unity-compat-samples/gallery/**",
       "maven/cil-translator/**",
       "maven/unity-compat/**",
+      "maven/compose-compat/**",
       "maven/build-engine/src/main/java/com/codename1/maven/Unity*",
       "maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*",
       "scripts/unity-gallery-prebuilt.sh",
@@ -102,6 +103,7 @@
       "scripts/unity-compat-samples/gallery/**",
       "maven/cil-translator/**",
       "maven/unity-compat/**",
+      "maven/compose-compat/**",
       "maven/build-engine/src/main/java/com/codename1/maven/Unity*",
       "maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*",
       "scripts/unity-gallery-prebuilt.sh",
@@ -145,6 +147,7 @@
       "scripts/unity-compat-samples/gallery/**",
       "maven/cil-translator/**",
       "maven/unity-compat/**",
+      "maven/compose-compat/**",
       "maven/build-engine/src/main/java/com/codename1/maven/Unity*",
       "maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*",
       "scripts/unity-gallery-prebuilt.sh",
@@ -186,6 +189,7 @@
       "scripts/unity-compat-samples/gallery/**",
       "maven/cil-translator/**",
       "maven/unity-compat/**",
+      "maven/compose-compat/**",
       "maven/build-engine/src/main/java/com/codename1/maven/Unity*",
       "maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*",
       "scripts/unity-gallery-prebuilt.sh",
@@ -214,6 +218,7 @@
       "scripts/unity-compat-samples/gallery/**",
       "maven/cil-translator/**",
       "maven/unity-compat/**",
+      "maven/compose-compat/**",
       "maven/build-engine/src/main/java/com/codename1/maven/Unity*",
       "maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*",
       "scripts/unity-gallery-prebuilt.sh",
@@ -240,6 +245,7 @@
       "scripts/unity-compat-samples/gallery/**",
       "maven/cil-translator/**",
       "maven/unity-compat/**",
+      "maven/compose-compat/**",
       "maven/build-engine/src/main/java/com/codename1/maven/Unity*",
       "maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*",
       "scripts/unity-gallery-prebuilt.sh",
@@ -284,6 +290,7 @@
       "scripts/unity-compat-samples/gallery/**",
       "maven/cil-translator/**",
       "maven/unity-compat/**",
+      "maven/compose-compat/**",
       "maven/build-engine/src/main/java/com/codename1/maven/Unity*",
       "maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*",
       "scripts/unity-gallery-prebuilt.sh",
@@ -320,6 +327,7 @@
       "scripts/unity-compat-samples/gallery/**",
       "maven/cil-translator/**",
       "maven/unity-compat/**",
+      "maven/compose-compat/**",
       "maven/build-engine/src/main/java/com/codename1/maven/Unity*",
       "maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*",
       "scripts/unity-gallery-prebuilt.sh",

.github/workflows/car-android.yml

@@ -13,6 +13,7 @@ name: Car (Android Auto) integration
       - 'scripts/unity-compat-samples/gallery/**'
       - 'maven/cil-translator/**'
       - 'maven/unity-compat/**'
+      - 'maven/compose-compat/**'
       - 'maven/build-engine/src/main/java/com/codename1/maven/Unity*'
       - 'maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*'
       - 'scripts/unity-gallery-prebuilt.sh'
@@ -46,6 +47,7 @@ name: Car (Android Auto) integration
       - 'scripts/unity-compat-samples/gallery/**'
       - 'maven/cil-translator/**'
       - 'maven/unity-compat/**'
+      - 'maven/compose-compat/**'
       - 'maven/build-engine/src/main/java/com/codename1/maven/Unity*'
       - 'maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*'
       - 'scripts/unity-gallery-prebuilt.sh'

.github/workflows/car-ios.yml

@@ -14,6 +14,7 @@ name: Car (CarPlay) integration
       - 'scripts/unity-compat-samples/gallery/**'
       - 'maven/cil-translator/**'
       - 'maven/unity-compat/**'
+      - 'maven/compose-compat/**'
       - 'maven/build-engine/src/main/java/com/codename1/maven/Unity*'
       - 'maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*'
       - 'scripts/unity-gallery-prebuilt.sh'
@@ -37,6 +38,7 @@ name: Car (CarPlay) integration
       - 'scripts/unity-compat-samples/gallery/**'
       - 'maven/cil-translator/**'
       - 'maven/unity-compat/**'
+      - 'maven/compose-compat/**'
       - 'maven/build-engine/src/main/java/com/codename1/maven/Unity*'
       - 'maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*'
       - 'scripts/unity-gallery-prebuilt.sh'

.github/workflows/check-doc-snippets.yml

@@ -17,6 +17,7 @@ on:
       - 'scripts/savor/**'
       - 'scripts/bastion/**'
       - 'scripts/skirmish/**'
+      - 'scripts/hellocodenameone/common/src/main/kmp/**'
       - 'docs/website/content/blog/**'
       - 'CodenameOne/src/**/*.java'
       - 'Ports/CLDC11/src/**/*.java'

.github/workflows/developer-guide-docs.yml

@@ -21,6 +21,7 @@ on:
       - 'scripts/bastion/**'
       - 'scripts/skirmish/**'
       - 'scripts/parley/**'
+      - 'scripts/hellocodenameone/common/src/main/kmp/**'
       - 'scripts/reel/**'
       # The API-name check derives the published pages from the javadoc's own
       # sources, and the guide links into the java.* compatibility classes --
@@ -133,14 +134,15 @@ jobs:
               - 'Ports/JavaSE/**'
               - 'maven/core/**'
               - 'maven/javase/**'
-              # The Wayline, Savor, Parley and Bastion chapters include these trees by tag, so a
+              # The Wayline, Savor, Parley, Bastion and Kotlin Multiplatform chapters include these trees by tag, so a
               # renamed or deleted tag there has to reach the snippet check.
               - 'scripts/wayline/**'
               - 'scripts/savor/**'
               - 'scripts/skirmish/**'
               - 'scripts/parley/**'
               - 'scripts/reel/**'
               - 'scripts/bastion/**'
+              - 'scripts/hellocodenameone/common/src/main/kmp/**'
             workflow:
               - '.github/workflows/developer-guide-docs.yml'
 

.github/workflows/health-android.yml

@@ -20,6 +20,7 @@ name: Health (Health Connect) integration
       - 'scripts/unity-compat-samples/gallery/**'
       - 'maven/cil-translator/**'
       - 'maven/unity-compat/**'
+      - 'maven/compose-compat/**'
       - 'maven/build-engine/src/main/java/com/codename1/maven/Unity*'
       - 'maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*'
       - 'scripts/unity-gallery-prebuilt.sh'
@@ -45,6 +46,7 @@ name: Health (Health Connect) integration
       - 'scripts/unity-compat-samples/gallery/**'
       - 'maven/cil-translator/**'
       - 'maven/unity-compat/**'
+      - 'maven/compose-compat/**'
       - 'maven/build-engine/src/main/java/com/codename1/maven/Unity*'
       - 'maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*'
       - 'scripts/unity-gallery-prebuilt.sh'

.github/workflows/kmp-compat.yml

@@ -0,0 +1,106 @@
+name: Kotlin Multiplatform compatibility
+
+# Compose Multiplatform code built as a Codename One application: the Compose UI
+# layer written over Codename One (maven/compose-compat, which carries the real
+# Compose runtime and kotlinx.coroutines as they are), the headless harness its
+# tests run on (maven/compat-testing) and the build steps that import and
+# package it (build-engine, the Maven and Gradle plugins, the archetype's
+# compose profile).
+#
+#   unit tests           layout, recomposition, text and input, and the
+#                        benchmark's Keynote application driven screen by
+#                        screen, headless; JDK 17, as the Compose runtime's
+#                        inline functions are JVM 11 bytecode
+#   kmp-compat-test.sh   every sample under scripts/kmp-compat-samples
+#                        imported unmodified, built by Maven and Gradle with
+#                        the Compose compiler, and staged for iOS, Android,
+#                        JavaScript and the desktop with identical uploads
+#                        from both tools
+#
+# No display anywhere: the CSS compiler is headless, and so is every test.
+on:
+  pull_request:
+    branches: [ master ]
+    paths:
+      - 'maven/compose-compat/**'
+      - 'maven/compat-testing/**'
+      - 'maven/build-engine/**'
+      - 'maven/codenameone-maven-plugin/**'
+      - 'maven/codenameone-gradle-plugin/**'
+      - 'maven/project-model/**'
+      - 'maven/cn1app-archetype/**'
+      - 'maven/pom.xml'
+      - 'maven/integration-tests/kmp-compat-test.sh'
+      - 'maven/integration-tests/inc/**'
+      - 'scripts/kmp-compat-samples/**'
+      # The unit tests drive the benchmark's shared application.
+      - 'scripts/kmp-bench/app/shared/**'
+      - '.github/workflows/kmp-compat.yml'
+  push:
+    branches: [ master ]
+    paths:
+      - 'maven/compose-compat/**'
+      - 'maven/compat-testing/**'
+      - 'maven/build-engine/**'
+      - 'maven/codenameone-maven-plugin/**'
+      - 'maven/codenameone-gradle-plugin/**'
+      - 'maven/project-model/**'
+      - 'maven/cn1app-archetype/**'
+      - 'maven/pom.xml'
+      - 'maven/integration-tests/kmp-compat-test.sh'
+      - 'maven/integration-tests/inc/**'
+      - 'scripts/kmp-compat-samples/**'
+      - 'scripts/kmp-bench/app/shared/**'
+      - '.github/workflows/kmp-compat.yml'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  kmp-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 and the Compose tests
+        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'
+      - 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 mvn install -Plocal-dev-javase -DskipTests -Darchetype.test.skip=true -Dmaven.javadoc.skip=true
+      - name: Unit tests
+        working-directory: maven
+        run: JAVA_HOME="$GRADLE_JAVA_HOME" mvn -B -Plocal-dev-javase -pl compose-compat test
+      - name: Refresh archetype catalog
+        run: |
+          cd maven
+          mvn archetype:update-local-catalog -Plocal-dev-javase
+          mvn archetype:crawl -Plocal-dev-javase
+      - name: Kotlin Multiplatform samples, imported and built by Maven and Gradle
+        working-directory: maven/integration-tests
+        run: bash kmp-compat-test.sh
+      - name: Upload the test projects' logs
+        if: failure()
+        uses: actions/upload-artifact@v7
+        with:
+          name: kmp-compat-logs
+          path: maven/integration-tests/build/kmp-compat/**/*.log
+          if-no-files-found: ignore

.github/workflows/linux-build-run.yml

@@ -37,6 +37,7 @@ on:
       - 'scripts/unity-compat-samples/gallery/**'
       - 'maven/cil-translator/**'
       - 'maven/unity-compat/**'
+      - 'maven/compose-compat/**'
       - 'maven/build-engine/src/main/java/com/codename1/maven/Unity*'
       - 'maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*'
       - 'scripts/unity-gallery-prebuilt.sh'
@@ -76,6 +77,7 @@ on:
       - 'scripts/unity-compat-samples/gallery/**'
       - 'maven/cil-translator/**'
       - 'maven/unity-compat/**'
+      - 'maven/compose-compat/**'
       - 'maven/build-engine/src/main/java/com/codename1/maven/Unity*'
       - 'maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*'
       - 'scripts/unity-gallery-prebuilt.sh'
@@ -162,7 +164,7 @@ jobs:
         run: |
           cd maven
           JAVA_HOME="$JDK_8_HOME" bash ../scripts/ci/retry.sh \
-            mvn -B -pl codenameone-maven-plugin,cn1-ads-mock,backend,backend-test -am \
+            mvn -B -pl codenameone-maven-plugin,cn1-ads-mock,compose-compat,backend,backend-test -am \
             -DskipTests '-Dmaven.javadoc.skip=true' '-Plocal-dev-javase' install
 
       # After everything that fills the local Maven repository and before the
@@ -233,6 +235,20 @@ jobs:
       - name: Install clang and time
         run: bash scripts/ci/apt-get-install.sh clang time
 
+      # The suite's C build compiles ~7,000 translation units, several of them
+      # large, with full debug info. On ubuntu-24.04-arm it exhausted memory and
+      # the runner was shut down mid-build, twice at the same step; extra swap
+      # lets the peak spill instead of taking the machine down.
+      - name: Add swap (arm64)
+        if: matrix.arch == 'arm64'
+        run: |
+          free -m
+          sudo fallocate -l 12G /cn1-swapfile
+          sudo chmod 600 /cn1-swapfile
+          sudo mkswap /cn1-swapfile
+          sudo swapon /cn1-swapfile
+          free -m
+
       - name: Set up JDK 8
         uses: actions/setup-java@v5
         with: { distribution: 'temurin', java-version: '8' }

.github/workflows/parparvm-tests-windows.yml

@@ -30,6 +30,7 @@ on:
       - 'scripts/unity-compat-samples/gallery/**'
       - 'maven/cil-translator/**'
       - 'maven/unity-compat/**'
+      - 'maven/compose-compat/**'
       - 'maven/build-engine/src/main/java/com/codename1/maven/Unity*'
       - 'maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*'
       - 'scripts/unity-gallery-prebuilt.sh'
@@ -63,6 +64,7 @@ on:
       - 'scripts/unity-compat-samples/gallery/**'
       - 'maven/cil-translator/**'
       - 'maven/unity-compat/**'
+      - 'maven/compose-compat/**'
       - 'maven/build-engine/src/main/java/com/codename1/maven/Unity*'
       - 'maven/codenameone-maven-plugin/src/main/java/com/codename1/maven/*Unity*'
       - 'scripts/unity-gallery-prebuilt.sh'
@@ -444,7 +446,7 @@ jobs:
               Write-Host "mvn failed; retrying in $delay s..."
               Start-Sleep -Seconds $delay
             }
-            mvn -B -pl windows,codenameone-maven-plugin,cn1-ads-mock,backend,backend-test -am -DskipTests '-Dmaven.javadoc.skip=true' '-Plocal-dev-javase' install
+            mvn -B -pl windows,codenameone-maven-plugin,cn1-ads-mock,compose-compat,backend,backend-test -am -DskipTests '-Dmaven.javadoc.skip=true' '-Plocal-dev-javase' install
             if ($LASTEXITCODE -eq 0) { $ok = $true; break }
           }
           if (-not $ok) { throw "mvn install failed after all retries" }

.github/workflows/pr.yml

@@ -402,7 +402,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,android-res-compiler,android-compat,swing-compat,javafx-compat,fxml-compiler,desktop-compat-runtime -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,swing-compat,javafx-compat,compose-compat,fxml-compiler,desktop-compat-runtime -am verify
       - name: Type-check the SQLCipher-backed database package
         if: ${{ matrix.java-version == 8 }}
         env:
@@ -620,7 +620,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:maven/android-res-compiler/target:maven/android-compat/target:maven/swing-compat/target:maven/javafx-compat/target:maven/fxml-compiler/target:maven/desktop-compat-runtime/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:maven/swing-compat/target:maven/javafx-compat/target:maven/compose-compat/target:maven/fxml-compiler/target:maven/desktop-compat-runtime/target
           QUALITY_REPORT_SERVER_URL: ${{ github.server_url }}
           QUALITY_REPORT_REPOSITORY: ${{ github.repository }}
           QUALITY_REPORT_REF: ${{ github.event.pull_request.head.sha || github.sha }}
@@ -644,6 +644,7 @@ jobs:
             "android-compat:maven/android-compat/target" \
             "swing-compat:maven/swing-compat/target" \
             "javafx-compat:maven/javafx-compat/target" \
+            "compose-compat:maven/compose-compat/target" \
             "fxml-compiler:maven/fxml-compiler/target" \
             "desktop-compat-runtime:maven/desktop-compat-runtime/target" \
             "project-model:maven/project-model/target" \
@@ -776,11 +777,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:maven/android-res-compiler/target:maven/android-compat/target:maven/swing-compat/target:maven/javafx-compat/target:maven/fxml-compiler/target:maven/desktop-compat-runtime/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:maven/swing-compat/target:maven/javafx-compat/target:maven/compose-compat/target:maven/fxml-compiler/target:maven/desktop-compat-runtime/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:android-res-compiler:android-compat:swing-compat:javafx-compat:fxml-compiler:desktop-compat-runtime
+          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:swing-compat:javafx-compat:compose-compat:fxml-compiler:desktop-compat-runtime
           # PMD and Checkstyle run on the core and on the backend runtime, and each
           # must produce its report: without one, the PMD gate below it
           # has nothing to read and passes.