Skip to content

v0.3.0-dev.2

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 28 Sep 20:13
· 116 commits to main since this release
Immutable release. Only release title and notes can be modified.
v0.3.0-dev.2
7f14568
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Borea v0.3.0-dev.2: test build for developers

This pre-release is for the Borea team and developers who want to test v0.3.0 before it is released.
It is not for users. For normal use, stay on v0.2.1.
Tell us what did not work: Discord | GitHub issues

Please test these first

  • The update channel: in Settings, General, switch "Update channel for Borea" between "Stable releases" and "All releases, dev builds included". The Home banner should follow the channel within a few seconds, without a restart.
  • On a Mac with a Sikarugir wrapper in ~/Applications/Sikarugir: the game detection should find KSA there.
  • On a Mac whose wrapper has no .NET runtime: the message should say in three steps how to install it, and "Check again" should start the game once it is there.

New since v0.3.0-dev.1

  • A change of the update channel, or turning "Check for updates at start" on, checks for a new Borea release at once. The Home banner and the release notes follow the new channel without a restart.
  • On a Mac, the game detection also finds Wine wrapper apps one folder below /Applications and ~/Applications, such as ~/Applications/Sikarugir/KSA.app, where Sikarugir saves its wrappers.
  • The message about a missing .NET runtime in a Mac wrapper names the version in its title and gives three numbered steps: download the installer, install it through "Install Software" in the Configure window of the wrapper, and click "Check again".
  • The listing editor reads the prefix of a forum thread by its id, so a prefix that the forum renames still gives the right tag.
  • The text of a purple button that holds only text sits in its center.
  • The Discover search field says what it searches, such as "Search 20 mods", and its text sits in the middle of the field, level with the search icon.

Also in v0.3.0-dev.1, but not named in its notes

  • Experimental: on a Mac, Borea can play the Windows build of KSA through a Wine wrapper such as Sikarugir.
  • Long lists scroll smoothly, also when you scroll fast from the end back to the top.

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. In v0.2.1 and v0.3.0-dev.1 the change takes effect at the next start, and from this build on it applies at once.
When v0.3.0 is released, every channel tells you about it.

Downloads

File SHA-256
Borea-0.3.0-dev.2-linux-x64.tar.gz 16836cce6971e969c307b18f3aab7e2eca9f92bd55e0d68e03bc7707e4c7e101
Borea-0.3.0-dev.2-macos-arm64.tar.gz 93ffac4f356bce13c23f99b7d73ae422e5c0227875da1a792b3330538330c466
Borea-0.3.0-dev.2-win-x64.zip 98c639e87bd50c8ba087758ff91bc9d3db3842df50e8206b1574e458d2562eb5
Borea-0.3.0-dev.2.cdx.json 32cc6bb65399845c249a604823aeadd00d4d694949c59a70c74f6cf1d2f2bce8
Borea-Cli-0.3.0-dev.2-linux-x64.tar.gz 8de29a1111aba7770e99ffbafa7504e002a066db68b7862edd9e8b933842cbe1
Borea-Cli-0.3.0-dev.2-macos-arm64.tar.gz 92d686d9bccd6add9ec4c7aae2802ec45cfa07199f91ce905b33188e08055e30
Borea-Cli-0.3.0-dev.2-win-x64.zip 7bf7f7f6588bffa97ce90e4971234fbe2ec42224ce615d3dae6d4ab417133ddb
Borea-Cli-0.3.0-dev.2.cdx.json 54ea8ec173c4371f37faa14a3b323d652c2e519e0c7e9a1b3d8c18f3f34afe23

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.
The App archive also contains BRANDING.md, because the Borea logo in the App is not covered by the MIT License.
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.
After the App has started once, Borea is in the application menu and starts from there without a terminal.
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.3.0-dev.2.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.3.0-dev.2.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

Full Changelog: v0.3.0-dev.1...v0.3.0-dev.2

Contributors

Maximilian-Nesslauer
Assets 12
Loading