If you are an OEM or an ISV working with an OEM to provide your app to be included in a PC image, you will need to provide the OEM with a 'preinstall package'. This post will review what a preinstall package is and how to generate them. Note that preinstall packages can only be created by Microsoft. Preinstalled apps also must be free and can't be changed to paid.
Sideloading or Preinstall
Preinstall apps are Microsoft Store apps that are integrated by OEMs into their OS images, the are the default apps available to user when they setup their PC for the first time. If an app is to be available in the Microsoft Store and an OEM device, the device OEM image must integrate a preinstall app package. This is to ensure version and binary continuity of the app and that the app is automatically updated from the Store. Enterprises can include line of business (LOB) apps into OS images via sideloading. See the documentation here for more on the Enterprise scenario. This post reviews the ISV / OEM scenario.
Partner Center and preinstall Permissions
-
OEMs and ISVs working with OEMs can request to have their Windows Developer Partner Center account provisioned with 'preinstall' permissions. Do this by emailing
partnerops@microsoft.com. -
Your email should include:
- Your Name
- Your Company Name
- Your Seller ID. (See Partner Center | Developer Settings | Account Settings)
- The OEM you're working with and other relevant information (PC Project, etc.)
- The contact information (Name and email address) of the OEM.
-
Once your account has been enabled with preinstall permissions, the Partner Center Windows app Manage packages page will be extended with the 'preinstallation' UI shown below:
Generating the preinstall package
- Click on 'Enable downloadable packages' (see screenshot above) to start the process of generating the preinstall package. Note the warning about the requirement for the app to be now and always free. (The app can contain in-app purchases). Make sure you intend for this app to be free.
- Click on 'Show packages' to see the available downloads. (Screenshot below.)
- Click on 'Download Windows 10 package' to download the preinstall package. (.zip)
The preinstall package
A preinstall package is a zip file that contains:
- A .APPX / .MSIX or .APPXBUNDLE / .MSIXBUNDLE signed by Microsoft.
- A license file (.xml)
- A provisioning file (.provxml)
- A file containing the Application User Model ID (AUMID) (.txt) of the application.
- It may contain additional dependencies in .APPX / .MSIX files.
Test the preinstall package
You can validate the app can be installed in the currently running OS with the files provided in the preinstall zip, with the following steps:
- Unzip the file into an empty folder.
- Start PowerShell as an administrator
- Change directory to the empty folder that contains the preinstall app files.
- Run the following command:
Add-AppxProvisionedPackage -Online -PackagePath .\myPackage.msix -LicensePath .\myLicense.xml
Additional parameters for Add-AppProvisionedPackage here.
After successfully running this command, run the app from the app list to verify the app starts as expected.
Additional documentation: Generate preinstall packages for OEMs - Windows UWP applications | Microsoft Docs
Happy Coding!