v0.2.0-dev.5

Borea v0.2.0-dev.5: test build for developers

This pre-release is for the Borea team and developers who want to test v0.2.0 before it is released.
It is not for playing. For normal use, stay on v0.1.0.
v0.2.0 follows right after this build.
Tell us what did not work: Discord | GitHub issues

Please test the update once more

This is the first build whose archive unpacks into a folder named Borea instead of one with the version in its name.
In dev.4, use "Update now" on the Home banner, or borea update-self, and tell us whether Borea restarts as dev.5 in the same folder.
Your folder keeps its name, because Borea updates itself into the folder it runs from.

New since v0.2.0-dev.4

• The App archive unpacks into Borea, and the CLI archive into Borea-Cli. Put that folder where it can stay, for example %LocalAppData%\Programs\Borea on Windows or ~/.local/share/Borea on Linux.

How to get the next test builds

With the default update channel, "Stable releases", Borea does not tell you about pre-releases like this one.
To see them, open Settings, General, and set "Update channel for Borea" to "All releases, dev builds included".
"Check for updates at start" must be on, and the change takes effect at the next start.
When v0.2.0 is released, every channel tells you about it.

Downloads

File	SHA-256
Borea-0.2.0-dev.5-linux-x64.tar.gz	2380ec2049e56f0774eb0e05482249e10e616565c5e0ee19d95a2f1ee19965f0
Borea-0.2.0-dev.5-macos-arm64.tar.gz	9fff0122a3214fdce690cef3465ee31afe607716459c8afa52df3cb7f0d40ff7
Borea-0.2.0-dev.5-win-x64.zip	3d103d4ca32648a64da4e304bf02204784f44d42b7af99c42cabb72821f3da88
Borea-0.2.0-dev.5.cdx.json	d6936ef6ca845b7149fb3be0faff6424bb4ae77ac68e471260d0219285f2ee6f
Borea-Cli-0.2.0-dev.5-linux-x64.tar.gz	3316a538ffce7f5a455e5d33c0267ac02454fdd4cc1cb109dbf87d7e935e8969
Borea-Cli-0.2.0-dev.5-macos-arm64.tar.gz	16a7aef2f186f0745c9bfbb261845c2eb363d11a6a36b5e99918ec423b8851f4
Borea-Cli-0.2.0-dev.5-win-x64.zip	c5b71e537b135625962380654e298ccf3c0ebb423e6884b2e8b0b20f7f6aa15d
Borea-Cli-0.2.0-dev.5.cdx.json	d1f409a833b605fa4a49b47027503c9b7dd22d192322c5ef16b7b9229782a0b1

Each platform has two archives.
The App archive, for example Borea-<version>-win-x64.zip, contains the program borea.
Without arguments, borea opens the desktop App, and with arguments, it runs a command.
Most users want this archive.
Archives whose names start with Borea-Cli- are a smaller download that contains only the command line.

The builds include the .NET runtime and are self-contained, so there is nothing to install first.

Each archive contains borea (borea.exe on Windows), LICENSE and THIRD-PARTY-NOTICES.txt, in a folder named Borea, or Borea-Cli for the CLI archive.
Put that folder where it can stay, for example %LocalAppData%\Programs\Borea on Windows or ~/.local/share/Borea on Linux, because Borea updates itself into the folder it runs from.

First start

These builds are not code signed, so the first start might take an extra step on Windows and macOS. The README has the long explanation.

Windows. Right-click the zip, open Properties and select Unblock.
Then unpack the App archive and start borea.exe, or run .\borea.exe --help in PowerShell in the unpacked folder of either archive.
Without that step, Windows shows "Windows protected your PC". This is because the file might not be downloaded often and is not signed. Select "More info", then "Run anyway".

Linux. Unpack the App archive and run ./borea for the App, or run ./borea --help in the unpacked folder of either archive.
Both need the ICU and OpenSSL libraries of your distribution, and only the App also needs the X11, ICE, SM and fontconfig libraries. Most desktop installs already have them. See Readme.

macOS. Unpack and start Borea from Terminal, not from Finder: tar -xzf <file>, then run ./borea inside the new folder of the App archive for the App, or ./borea --help inside the new folder of either archive.
The macOS builds are for Apple silicon. Intel Macs are not supported.

Provenance

To check that a file came from this workflow:

gh attestation verify <file> --repo KSAModding/Borea \
  --signer-workflow KSAModding/Borea/.github/workflows/release.yml

Borea-0.2.0-dev.5.cdx.json is the software bill of materials for the App archives, in CycloneDX JSON.
The App contains the command line, so this list includes the NuGet packages of the App and of the CLI.
Borea-Cli-0.2.0-dev.5.cdx.json is the software bill of materials for the CLI archives and includes only the packages of the CLI.
Each list includes the version, license and hash of every package.
Each list is attested only to the archives that it describes, and you can use this command to prove that it belongs to one.
With --format json, the output includes the attested list.

gh attestation verify <archive> --repo KSAModding/Borea \
  --signer-workflow KSAModding/Borea/.github/workflows/release.yml \
  --predicate-type https://cyclonedx.org/bom

Signing will come in the future and is tracked in #76.

What's Changed

• Record the game data changes instead of reading the rows during the load by @Maximilian-Nesslauer in #524
• Pack the release archives under a folder without the version by @Maximilian-Nesslauer in #526
• Add the introduction for v0.2.0-dev.5 by @Maximilian-Nesslauer in #528

Full Changelog: v0.2.0-dev.4...v0.2.0-dev.5