Skip to content

Implement MSIX packaging and Microsoft Store distribution #786

Description

@AgreeDK

Current State

Following the Facebook community poll and investigation in #734, the
decision is to distribute OpenSAK on Windows via both channels:

  • Microsoft Store (MSIX) — no SmartScreen warning, auto-updates handled
    by Windows, free publisher account
  • Direct .exe on GitHub — unchanged, existing PyInstaller build

#564 (paid Windows code signing certificate) is on hold as a result, with
MSIX as the primary path to remove the SmartScreen warning at no ongoing
cost.

Open risk to validate first

QtWebEngine embeds a Chromium runtime, which can trigger extra scrutiny
during Microsoft Store certification. This should be tested with a minimal
prototype before committing further effort — if certification rejects
the app, #564 becomes the fallback again.

Proposed Improvement

Steps

  1. Prototype MSIX packaging
    • Package a build of OpenSAK as MSIX (e.g. via pyinstaller output +
      MSIX Packaging Tool, or msix-packaging-tool CLI for CI use)
    • Submit to Microsoft Partner Center as a private/unlisted test
      submission to check certification passes with QtWebEngine included
  2. Confirm install path prerequisites (depends on Proper Windows installer with fixed install path (stable Start Menu shortcut across updates) #599)
  3. CI/CD integration
    • Add an MSIX build job to the existing GitHub Actions Windows pipeline
    • Decide submission cadence: automatic per-release vs. manual review
      before each Store submission (Store certification can take hours to
      days, unlike direct .exe releases)
  4. Store listing setup
    • Create free Microsoft Store developer account (individual, per 2026
      fee removal)
    • Store listing: description, screenshots, privacy policy link
      (opensak.com)
  5. Update documentation and download page

Verification

  • MSIX package installs cleanly on a clean Windows 10/11 VM
  • Store certification passes without QtWebEngine-related rejection
  • App launches, functions normally, and appears correctly in Start Menu
    under the Store-managed install path
  • CI pipeline produces a valid MSIX artifact on tag push

Expected Benefits

Closure criteria

  • MSIX build is live in the Microsoft Store
  • Both distribution channels documented on opensak.com and in README
  • Funding: Microsoft code signing certificate #564 revisited: closed as not-needed if MSIX proves stable, or
    reactivated if Store certification is a blocker

Related issues

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions