Skip to content

feat: add native app-image launcher distribution#172

Open
golemcore1 wants to merge 1 commit intomainfrom
feat/native-app-image-launcher
Open

feat: add native app-image launcher distribution#172
golemcore1 wants to merge 1 commit intomainfrom
feat/native-app-image-launcher

Conversation

@golemcore1
Copy link
Collaborator

Summary

This PR introduces a native local distribution path for GolemCore Bot and makes the launcher behavior consistent across staged updates, bundled app-image runtime jars, and the legacy classpath fallback.

At the packaging level, the release workflow now builds platform-specific native app-image bundles in addition to the executable JAR and publishes those archives together with updated SHA-256 checksums. To support local development and manual packaging, the repository also gains a reusable build script under .github/scripts/ plus an npx entry point that generates the same native archive format locally.

At runtime, RuntimeLauncher is extended so that a native launcher can start the bot using the same self-update model that already exists for the JAR flow. The launcher now resolves runtime in a deterministic order: first a staged update selected through updates/current.txt, then the bundled runtime JAR embedded in the app-image, and finally the existing Jib/classpath fallback. This keeps local native bundles compatible with staged updates without introducing a separate execution model.

The launcher also now forwards JVM system properties to the spawned runtime process, which is important for operational overrides such as -Dserver.port=..., storage path overrides, update path overrides, and other JVM-level configuration passed at startup. Spring-style application arguments such as --server.port=... continue to work as before, and the implementation avoids duplicating overrides when both property sources are present.

To make the new behavior durable, the test suite for RuntimeLauncher is expanded to cover bundled runtime resolution, environment/property-based overrides, forwarding of JVM system properties, precedence rules, and the fallback path when no valid bundled runtime JAR is available.

Documentation is updated across the README, quick start, deployment guide, and configuration reference so users can understand:

  • how to build the native app-image locally
  • what files are produced
  • how the launcher resolves runtime
  • how to override the server port and other startup properties
  • how native archives are now included in release assets

@sonarqubecloud
Copy link

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant