Document published 1.0.1 and verified public update feed
All checks were successful
Release AstroFrame / packages (push) Successful in 52s
All checks were successful
Release AstroFrame / packages (push) Successful in 52s
This commit is contained in:
parent
87d2c24288
commit
1e8e8c88fe
2 changed files with 10 additions and 10 deletions
|
|
@ -2,7 +2,7 @@
|
|||
|
||||
## First release
|
||||
|
||||
Version **1.0.0** targets x64 Windows and Linux desktops. Windows uses a per-user Velopack installer. Linux uses one self-contained AppImage plus an optional per-user application-menu installer; the same binary targets both Debian and Arch. No Git client, Python, .NET runtime installation or administrator access is required to install AstroFrame itself.
|
||||
The first published version, **1.0.1**, targets x64 Windows and Linux desktops. Download it from [the release page](https://git.elijahkuntz.com/Elijah/AstroFrame/releases/tag/v1.0.1). Windows uses a per-user Velopack installer. Linux uses one self-contained AppImage plus an optional per-user application-menu installer; the same binary targets both Debian and Arch. No Git client, Python, .NET runtime installation or administrator access is required to install AstroFrame itself.
|
||||
|
||||
### Windows
|
||||
|
||||
|
|
@ -59,15 +59,15 @@ Once this workflow is committed and pushed, enable Actions for the AstroFrame re
|
|||
To release a new version:
|
||||
|
||||
```powershell
|
||||
./packaging/Set-Version.ps1 -Version 1.0.1
|
||||
./packaging/Set-Version.ps1 -Version 1.0.2
|
||||
git add Directory.Build.props
|
||||
git commit -m "Release 1.0.1"
|
||||
git commit -m "Release 1.0.2"
|
||||
git push origin main
|
||||
git tag v1.0.1
|
||||
git push origin v1.0.1
|
||||
git tag v1.0.2
|
||||
git push origin v1.0.2
|
||||
```
|
||||
|
||||
Include all intended source changes in the release commit before tagging. The pushed tag is the publication trigger; ordinary commits to `main` run the build and checks without publishing. The version in `Directory.Build.props` must exactly match the tag. For the first release, use `v1.0.0` after pushing this workflow and the finalized source.
|
||||
Include all intended source changes in the release commit before tagging. The pushed tag is the publication trigger; ordinary commits to `main` run the build and checks without publishing. The version in `Directory.Build.props` must exactly match the tag. Version `v1.0.1` is published; `v1.0.0` remains an unpublished tag from the first failed publishing attempt. Choose a new version for each later release.
|
||||
|
||||
The job runs the engine, updater and release-publisher validation suites, builds both packages, renders the Linux settings page under Xvfb, then uploads everything into one draft release. Only after all uploads succeed does it make the release public, so users cannot discover an incomplete update. No local installer build or manual asset attachment is needed.
|
||||
|
||||
|
|
@ -89,14 +89,14 @@ The Windows script cross-packages both platforms. Results appear in `artifacts/r
|
|||
On Linux with a .NET 10 SDK:
|
||||
|
||||
```sh
|
||||
bash packaging/release.sh 1.0.0
|
||||
bash packaging/release.sh 1.0.1
|
||||
```
|
||||
|
||||
That script builds the Linux channel. The tool manifest pins Velopack CLI 1.2.161, matching the application's SDK dependency. Building on Windows is enough to create both packages, but compatibility should still be checked on target Linux desktops.
|
||||
|
||||
## Publish to the repository
|
||||
|
||||
Commit and push the versioned source first. The initial release has **not** been uploaded by this implementation. To make update discovery live, create a public stable release tagged `v1.0.0` and attach the files described below.
|
||||
Commit and push the versioned source first. Version `v1.0.1` was built and published automatically by the server. The following local publisher is an alternative to the tag workflow for future versions.
|
||||
|
||||
The helper script reads a repository-write token from `ASTROFRAME_RELEASE_TOKEN` in the process environment. On the server this is supplied automatically by the workflow. For local publication, set your own Gitea/Forgejo repository-write token. The script uploads both platforms into one draft, including the Linux installation helpers. It does not store the token or embed it in the application:
|
||||
|
||||
|
|
@ -129,6 +129,6 @@ dotnet run --project tests/AstroFrame.Updates.Validation -c Release -- artifacts
|
|||
|
||||
That test feed must contain a **1.0.1** package for the requested channel; it is not a production release. An explicit packaged-app `--verify-update <local feed directory> <report.jsonl> --apply` probe verifies actual replacement and restart. A `--capture-settings <output.png> [width] [dpi]` diagnostic captures the real settings page.
|
||||
|
||||
Both Windows and Linux local 1.0.0 → 1.0.1 replacement/restart were exercised during implementation. Linux rendering and per-user installation were checked under Ubuntu WSL with the missing ICU/X11 libraries extracted into a workspace test directory. Debian and Arch desktop execution have not yet been tested directly; those compatibility targets are based on the cross-platform runtime and documented system dependencies, not separate distro acceptance runs. The public repository API was verified anonymously; it currently contains no published releases.
|
||||
Both Windows and Linux local 1.0.0 → 1.0.1 replacement/restart were exercised during implementation. Linux rendering and per-user installation were checked under Ubuntu WSL with the missing ICU/X11 libraries extracted into a workspace test directory. Debian and Arch desktop execution have not yet been tested directly; those compatibility targets are based on the cross-platform runtime and documented system dependencies, not separate distro acceptance runs. Server run #8 built and published version 1.0.1 with all 13 assets, passed 39 engine, 18 updater and 10 publisher checks, and rendered the packaged Linux settings page under Debian Bookworm. A packaged Linux 1.0.0 app also discovered and downloaded the public 1.0.1 update through the real Gitea source with checksum validation.
|
||||
|
||||
References: [Velopack C# integration](https://docs.velopack.io/getting-started/csharp), [cross-packaging](https://docs.velopack.io/packaging/cross-compiling), [Linux update behavior](https://docs.velopack.io/packaging/operating-systems/linux), [Gitea distribution](https://docs.velopack.io/distributing/self-hosting), [Avalonia Linux dependencies](https://v11.docs.avaloniaui.net/docs/overview/supported-platforms/).
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue