Skip to content

Make installation portable and fix desktop build prerequisites - #22

Merged
JBailes merged 4 commits into
mainfrom
refactor/portable-installation
Nov 16, 2026
Merged

JBailes merged 4 commits into
mainfrom
refactor/portable-installation

Conversation

@JBailes

@JBailes JBailes commented Nov 16, 2026 •

Copy link
Copy Markdown
Contributor

Move retail installation and media validation out of Godot, vendor the matching published SDK, and fix the desktop-build prerequisite/provenance failures reported in #21.

The game’s installer and unchanged digest catalog now live in Vagrant.Gameplay; the catalog is an embedded .NET resource. wol-engine’s portable core owns generic disc/content-pack mechanisms and IMediaTools, while its Godot backend owns bundled-tool discovery and child execution. The existing host cache preparation remains in RetailContent. Game-specific STR flags, frame/channel/duration checks, XA integrity and cache publication remain in Vagrant.

Fixes for #22:

  • Downloaded all three native-CI-built SDKs and checksum files from runtime-a66481a4008acb84091ab9f9049437efb81f8fc5 and independently audited them before vendoring. Engine #153 and release Publish desktop preview releases and strengthen content audits #7 are merged; no locally built SDK DLL is vendored.
  • Preserve each SDK’s original portable core alongside its managed/API assemblies. macOS carries a different .NET regex-generator build stamp, so treating core DLLs as byte-identical shared resources was invalid. No DLL bytes are rewritten. Directory.Build.props selects the target consistently for gameplay, tests and the host, and package audits check the corresponding published core.

Fixes #21:

  • Run the .NET SDK resolver against global.json before downloads or player output, reporting the pinned 10.0.403 requirement and installed SDKs. The qualified SDK pin is retained.
  • Check Windows MSYS2/MINGW64 Bash, make, pkgconf, diff and GCC/binutils before export; explain the package command and MSYS2_ROOT. Check native Linux/macOS media prerequisites too, including active Xcode tools.
  • Read Git provenance before expensive work. Source ZIPs require no Git and explicitly record unknown revision/dirty state instead of crashing at BUILD.json creation. Git checkouts retain actual revision/status checks; damaged metadata fails early.
  • Document the complete toolchains and archive behavior. Prerequisite errors are grouped and actionable, and leave no partial player output.

Validation:

  • Fourteen release-tool tests cover missing/incompatible prerequisites, custom/incomplete MSYS2, inactive Xcode tools, source-ZIP and real Git provenance, early failure, original platform-core bytes, common-resource rejection and private-source rejection. CI runs them on all three hosts before player builds.
  • Portable gameplay/install contracts pass against the published core. The exported-player media verification remains required on every target.
  • Headless attachment, animation-script and room-ordering checks pass against the published SDK. Workflow lint, Python syntax and diff checks pass.
  • All nine checks pass on the final revision: release-tool tests, portable gameplay tests, and native player builds/audits/exported-player verification on Windows, Linux and universal macOS. CI: https://github.com/RakuenSoftware/vagrant/actions/runs/43848246974 No distribution image was built locally, and no disc data, captures or private engine implementation source are committed.

The README explicitly credits ser-pounce/rood-reverse for the data-structure/file-format reference work and retains the merged project-purpose explanation. Character rendering, audio playback and scene/UI presentation still remain to be extracted.

Closes #21.

@JBailes JBailes changed the title Decouple retail installation and catalog loading from Godot Make retail installation and media validation independent of Godot Nov 16, 2026
@JBailes JBailes changed the title Make retail installation and media validation independent of Godot Make installation portable and fix desktop build prerequisites Nov 16, 2026
@JBailes
JBailes merged commit 773d3fc into main Nov 16, 2026
10 checks passed
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.

Windows build: tools/release.py fails on undeclared prerequisites (.NET SDK pin, MSYS2, git)

1 participant