arch-packaging

Distribution packaging architecture for SGE games.

Key Files

• sge-build/src/main/scala/sge/sbt/SgePackaging.scala — Core packaging logic
• sge-build/src/main/scala/sge/sbt/SgePlugins.scala — SgeDesktopJvmPlatform, SgeBrowserPlatform, SgeDesktopNativePlatform, SgeAndroidPlatform
• demos/build.sbt — Demo packaging configuration

Packaging Modes

1. Simple (sgePackage): bin/ + lib/ + native/ with launcher scripts, requires system JDK
2. Distribution (sgePackageAll): Self-contained per-platform archives with jlinked JRE + Roast launcher
3. Browser (sgePackageBrowser): Scala.js fullLinkJS + index.html + assets
4. Native (sgePackageNative): Scala Native executable + shared libs
5. Android (androidSign): APK via D8 + aapt2 + apksigner

Cross-Platform JVM Distribution

• sgeCrossNativeLibDir setting: points to sge-deps/native-components/target/cross/ (CI staging area)
• Native libs built externally in sge-native-providers, distributed as provider JARs
• CI extracts provider JARs to the staging dir; per-platform libs in cross/<classifier>/
• ANGLE libs (libEGL, libGLESv2) bundled alongside Rust libs
• Static curl libs (from stunnel/static-curl) for self-contained Scala Native releases
• macOS .app bundles with ad-hoc codesigning

Release Workflow

Native libs are built externally in sge-native-providers and distributed as provider JARs from Maven. The release flow consumes those provider JARs and builds the per-platform demo archives via sbt command aliases defined in demos/build.sbt.

re-scale build publish-local --all                # Publish SGE to local Maven (JVM + JS + Native)
re-scale runner release-build                     # sbt --client releaseAll (in demos/)
re-scale runner release-collect                   # sbt --client collectReleases — demos/target/releases/
re-scale runner android-build-all                 # sbt --client androidAll — all 11 demo APKs

Per-demo (single demo) is wired via sbt command aliases inside demos/, e.g. cd demos && sbt --client releasePong for the JVM/Browser/Native trio of the Pong demo, or sbt --client androidPong for the APK alone.

Verification

Manual archive launch / smoke verification was previously done by legacy shell wrappers that are no longer present. There are no equivalent sbt tasks yet — verify by running the integration test runners on the host platform:

re-scale runner desktop-it                        # GLFW + ANGLE + miniaudio integration test
re-scale runner browser-it                        # Playwright + headless Chromium
re-scale runner android-it                        # Android emulator smoke test
re-scale runner native-ffi-it                     # Scala Native C ABI wiring

Load the SgePackaging source for implementation details: $READ sge-build/src/main/scala/sge/sbt/SgePackaging.scala