Skip to content

RELEASING.md

Latest commit

 

History

History
124 lines (94 loc) · 5.06 KB

RELEASING.md

File metadata and controls

124 lines (94 loc) · 5.06 KB
Raw

Cutting a release

Everything a release needs is produced by one script. The only manual part is the GitHub release itself, because attaching the files is what makes the updater see the new version.

0. Before anything

  1. Build the game and verify the artifact - ninja can report success without relinking because of the space in the path. The same breakage leaves a stale rexgpu-xenos.dll behind: it is copied in from the SDK by a rule ninja stops tracking. After touching SDK graphics code, copy it across by hand, or the game you are about to test still runs last week's plugin:

    Copy-Item rexglue-sdk\out\win-amd64\Release\rexgpu-xenos.dll `
          rexlego\out\build\win-amd64-release\ -Force

    build-installer.ps1 warns when the build directory's copy is older than the SDK's and ships the newer one, but that is a last line of defence, not a fix.

    # from the repository root
cmake --build rexlego\out\build\win-amd64-release --target legodimensions
Get-Item rexlego\out\build\win-amd64-release\legodimensions.exe |
    Select-Object Length, LastWriteTime

    The timestamp must be from this build. If it is not, the build did nothing.

  2. Bump VERSION in the workspace root (1.0.0 -> 1.0.1). The build script reads it, -p:Version stamps it into the installer, and the updater compares against it.

1. Build

cd rexlego-installer
.\build-installer.ps1                       # version from ..\VERSION
.\build-installer.ps1 -Notes "Fixes the X"  # notes shown in the updater

If this release adds a key to the plan in TomlConfig.cs, pass it here too:

.\build-installer.ps1 -TomlDefaults @{ toypad_emulation = "true" }
.\build-installer.ps1 -TomlForced   @{ some_compat_switch = "false" }

Run those in the current session, calling the script with & if you need to. Going through powershell -File .\build-installer.ps1 -TomlForced @{ ... } stringifies the hashtable on the way in, and the script dies with "Cannot convert the System.Collections.Hashtable value of type System.String".

A fresh install gets the new key from the plan compiled into Setup.exe, but an update is applied by the previous release's rexupdate.exe, which has never heard of it. Putting it in the manifest is what makes existing installs pick it up. -TomlForced for compatibility switches that must be rewritten even if the user changed them, -TomlDefaults for everything else.

Out comes:

File What it is
dist\DimensionsRecompiled-Setup.exe ~175 MB, full install, no dependencies
dist\update-<version>.rxp only the files that changed since the previous release
releases\<version>.json the manifest of this release - commit it

update-<version>.rxp only appears when releases\ already holds an earlier manifest to diff against. The very first release (1.0.0) has no pack, which is correct: there is nothing to update from yet.

releases\<version>.json is what makes the next build's pack small. If it is not committed, the next release ships a pack the size of the installer.

2. Smoke-test

  • Install dist\DimensionsRecompiled-Setup.exe into a throwaway folder.
  • Start the game once. F4 -> Updates must list updates_check, updates_repo, updater_path.
  • tools\rexupdate\rexupdate.exe --check --console must print either "No newer version" or the version it found, and exit cleanly.

3. The GitHub release

Repository: NeverCookFirst/DimensionsRecomp

# from the repository root
git add -A ; git commit -m "Release 1.0.1" ; git push
git tag v1.0.1 ; git push origin v1.0.1
gh release create v1.0.1 `
    "rexlego-installer\dist\DimensionsRecompiled-Setup.exe" `
    "rexlego-installer\dist\update-1.0.1.rxp" `
    --title "Dimensions Recompiled 1.0.1" --notes-file notes.md

Rules the updater depends on:

  • The tag is v<version>; the version inside it must match VERSION.
  • The installer asset is named exactly DimensionsRecompiled-Setup.exe.
  • The pack asset ends in .rxp.
  • The release body is what the updater shows as the changelog.
  • A pre-release is picked up too, so mark a test build as a pre-release only if you do want testers to be offered it.

4. The repository must be readable

The updater talks to the public GitHub API, so the repository has to be readable without a token. NeverCookFirst/DimensionsRecomp is public, and that is what makes releases visible to everyone's updater.

If it is ever made private again, nobody's updater can see or download a release until a personal access token is dropped in tools\rexupdate\token.txt on each machine (also honoured: --token, GITHUB_TOKEN). Without one the updater fails with a clean "not found" and the game carries on as normal - nothing breaks, updates simply never appear.

5. If a release turns out bad

Delete the release (or un-tag it). Anyone who already updated can run the previous Setup.exe over the same folder - it repairs the install and keeps saves - or restore by hand from backup\<old version>\ inside the install.