Skip to main content

Windows Installer (Shopkeeper App)

The shopkeeper app can be distributed as a Windows installer so shopkeepers install it like any other application. Two options are supported:

TypeOutputInstall locationDesktop shortcutLogo background
MSIX.msixOS drive (managed by Windows)Created automaticallyWhite (patched)
Classic (Inno Setup).exeUser chooses (default: Program Files)Optional checkbox in installerWhite/transparent

Quick build (MSIX)​

From shopkeeper_app:

build_installer.bat

This will:

  1. Ensure SumatraPDF (and optionally LibreOffice) are in place
  2. Create a signing certificate (if missing) so the installer shows Publisher: Qprint instead of "Msix Testing"
  3. Run dart run msix:create to build the app and create the MSIX package
  4. Patch the MSIX: white logo background (installer and Start tile), desktop shortcut ("Qprint Shop"). Requires Windows SDK (MakeAppx.exe).
  5. Optionally build the classic .exe installer if Inno Setup is in PATH

Output: build\windows\runner\Release\*.msix or build\windows\x64\runner\Release\*.msix

Classic installer (install dir + shortcut option)​

For an installer that lets the user choose the install directory (default: Program Files) and opt in or out of a desktop shortcut:

  1. Install Inno Setup
  2. Build the Windows app: flutter build windows (or run build_installer.bat first to get the MSIX build)
  3. From shopkeeper_app, run: iscc installer_script.iss

Output: build\windows\installer\QprintShop_Setup.exe

If your Flutter build output is in build\windows\runner\Release instead of x64\runner\Release, edit the #define BuildPath at the top of installer_script.iss.

Configuration​

  • MSIX: All settings are in pubspec.yaml under msix_config (display_name, publisher_display_name, logo_path, certificate_path, certificate_password, publisher, windows_build_args). See Build and Production.
  • Certificate: The script scripts\create_signing_cert.ps1 creates windows\Qprint.pfx; the cert is used so the MSIX installer shows "Publisher: Qprint". The .pfx is in .gitignore.

Full details (prerequisites, manual steps, configuration) are in the app folder: shopkeeper_app/WINDOWS_INSTALLER.md.

Last Updated: February 2026