release

name	release
description	Build and ship a hyprv Release as a signed MSIX bundle (x64 + ARM64) distributed via an .appinstaller on GitHub Releases. Use this when cutting a version, stamping the manifest/.rc versions, packaging, signing, or attaching release assets.

Release / distribution

Debug = unpackaged. Release ships as a signed MSIX bundle (x64 + ARM64) via an .appinstaller on GitHub Releases (github.com/jxy-s/hyprv). One sequence:

pwsh tools/set-version.ps1 1.0.0.2   # stamp manifest Identity + both .rc FILEVERSION/PRODUCTVERSION in lockstep
pwsh tools/make-msix.ps1             # clean -> per-arch -> makeappx bundle -> Trusted-sign -> emit .appinstaller; prints the gh release line

• Framework-dependent (self-contained is broken for this WinUI stack — gotcha #50). The runtime is a PackageDependency; the .appinstaller <Dependencies> auto-installs it (gotcha #51).
• Azure Trusted Signing — you az login (need the "Trusted Signing Certificate Profile Signer" role); the script signs against that session. Never handle the maintainer's Azure creds — direct them to do it.
• Release assets (attach all four, exact filenames): hyprv.msixbundle, Microsoft.WindowsAppRuntime.2-x64.msix, Microsoft.WindowsAppRuntime.2-arm64.msix, hyprv.appinstaller. Install = download the .appinstaller and double-click (the ms-appinstaller: web protocol is disabled by default).
• Packaging lives in src/package/ (hyprv-package.wapproj, Package.appxmanifest, hyprv.appinstaller.template, Assets/). Gotchas #50–54.

Where the pieces live

Concern	File(s)
MSIX packaging (manifest, wapproj, assets)	src/package/{Package.appxmanifest, hyprv-package.wapproj, Assets/}
.appinstaller template (auto-update + runtime dep)	src/package/hyprv.appinstaller.template (→ dist/hyprv.appinstaller)
Build/sign the signed MSIX bundle release	tools/make-msix.ps1
Stamp version across manifest + both .rc	tools/set-version.ps1 X.Y.Z.W
EXE version metadata (Explorer Properties)	src/app/hyprv.rc, src/rdphost/hyprv-rdphost.rc (VERSIONINFO)
Settings + log path (real %LOCALAPPDATA% on MSIX)	src/app/settings/Settings.cpp (LocalAppDataDir) + src/package/Package.appxmanifest (unvirtualizedResources)

See docs/GOTCHAS.md (MSIX / release / packaging / robustness section) for the full detail behind gotchas #50–54.