Skip to content

feat: 📦 add Microsoft Store (MSIX) package - #37

Merged
amd989 merged 7 commits into
masterfrom
feat/microsoft-store
Nov 7, 2026
Merged

amd989 merged 7 commits into
masterfrom
feat/microsoft-store

Conversation

@amd989

@amd989 amd989 commented Nov 6, 2026 •

Copy link
Copy Markdown
Owner

Summary

Adds a Microsoft Store edition alongside ClickOnce and the portable zip. Version 4.2.0.0 is already submitted to the Store (Store ID 9P8H93Z0TGK4); this branch is what the next upload builds from.

  • build-msix.ps1 publishes Symlinker self-contained for x64 and arm64, packs each with makeappx, and bundles them into Symlinker/bin/msix/Symlinker-<version>.msixbundle. The bundle is unsigned because Partner Center signs Store packages.
  • The script checks what the Store will see (version, architecture, capabilities, and that the exe does not ask for admin at launch). -Install registers the unpacked package for a test run (Developer Mode), and -Wack test-signs, installs and runs the Windows App Certification Kit (administrator shell).
  • packaging/msix/ holds the AppxManifest.xml template (Partner Center identity) and tile assets generated from icon.ico.
  • packaging/msix/store/ keeps the Store listing in the repo: the text for all 9 package languages, a screenshot tool that renders the real window in each language, and make-listings.ps1, which fills Partner Center's import template. Its README covers the import steps, Partner Center's rules, the restricted capability text and the certification notes.
  • The release workflow builds the bundle on tag pushes and uploads it as the msix-<version> artifact for manual submission.
  • PRIVACY.md covers admin rights and how each edition updates.

How the Store build differs

  • Elevation: none at launch. With feat: elevate only the link step instead of restarting as admin #41 the window stays unelevated and a hidden helper elevates only for symbolic links that need admin. The allowElevation capability lets that helper show the UAC prompt from inside the package. Drag and drop works in the Store build too.
  • AppData virtualization: MSIX redirects writes under AppData to a private package folder, so links users create there would land in the wrong place. The manifest disables file and registry write virtualization (unvirtualizedResources).
  • Display name: Properties/DisplayName is "Symlinker - Symlink Creator" because Partner Center only accepts reserved names and "Symlinker" alone is taken. The Start menu still shows "Symlinker".

Testing

  • ./build-msix.ps1 -Version 4.3.0 -Wack (administrator shell, Developer Mode off): all package checks pass; the exe embeds asInvoker. The certification kit reports WARNING only, for "Blocked executables" (.NET runtime DLLs reference process launch APIs) and DPI awareness (it can't read the exe). No failures.
  • Ran the installed, test-signed package with a symbolic link prefilled under %LOCALAPPDATA%:
    • The window process was unelevated.
    • Create link showed one UAC prompt; the elevated helper started from the package.
    • The symbolic link landed in the real %LOCALAPPDATA% folder, not the package's LocalCache.
    • The helper exited when the window closed.
  • From inside the package context, a folder created under %LOCALAPPDATA% lands in the real location.
  • make-listings.ps1 builds 27 screenshots and both CSV files.
  • dotnet test: 169 passed, 3 skipped (symbolic link tests need Developer Mode or an elevated shell). Locally that trips the 100% coverage gate; CI runs elevated.
  • Version 4.2.0.0 of this package went through Partner Center validation and is submitted.

Reviewer notes

🤖 Generated with Claude Code

@amd989
amd989 force-pushed the feat/microsoft-store branch 2 times, most recently from 302d32f to c970a97 Compare November 6, 2026 12:43
amd989 and others added 7 commits November 6, 2026 17:56
build-msix.ps1 builds a self-contained x64 + arm64 .msixbundle for
Partner Center, which signs it. The release workflow uploads it as an
artifact.

The Store build uses its own app manifest that asks for admin at start,
since a packaged app cannot relaunch itself with runas. The package
turns off AppData write virtualization so links land where users point.
Program.cs skips the relaunch when already elevated.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Cover admin rights, update checks per edition, and link the web version
for the Microsoft Store listing.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Mirror the Readout Store script: verify each package's version,
architecture, capabilities and the exe's requireAdministrator manifest,
print where to upload the bundle, and add -Install (register the unpacked
package) and -Wack (test-sign, install and run the certification kit).
An earlier test copy is removed first so rebuilds don't break it.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
RuntimeInformation.OSArchitecture is missing in 5.1; read the native
architecture from the registry instead.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Partner Center rejects packages whose Properties/DisplayName is not a
reserved name, and "Symlinker" alone is taken. The Start menu name stays
"Symlinker".

Co-Authored-By: Claude Opus 5.5 <[email protected]>
- listings.json holds the listing text for all 9 package languages
- ScreenshotTool renders the real main window in each language at 2.5x
  under a headline on a 1920x1080 image
- make-listings.ps1 builds the screenshots and fills the exported Partner
  Center template (with and without screenshots)
- README covers the import steps, Partner Center rules, the restricted
  capability text and the certification notes

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Now that only the link step elevates (#41), the Store build no longer
needs requireAdministrator. The window starts unelevated, so drag and
drop works, and the hidden link helper shows the UAC prompt through the
allowElevation capability.

- Remove Properties/app.msix.manifest and the MsixBuild switch
- build-msix.ps1 now fails if the exe asks for admin at launch
- Update CLAUDE.md and the privacy policy

Tested with a signed copy of the package and Developer Mode off: the
window ran unelevated, Create link showed one UAC prompt, and the
symbolic link landed in the real %LOCALAPPDATA% folder.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@amd989
amd989 force-pushed the feat/microsoft-store branch from c970a97 to bea8711 Compare November 7, 2026 11:47
@amd989
amd989 merged commit 51af377 into master Nov 7, 2026
1 check passed
@amd989
amd989 deleted the feat/microsoft-store branch November 7, 2026 12:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant