MSIX is the latest app packaging format from Microsoft that provides a cleaner and more reliable experience for app installation. To learn more about MSIX as a packaging format and all of its benefits, check out the MSIX Overview documentation.
There are several paths when it comes to migrating your applications to MSIX, depending on what state they are in. This section of documentation will help you if you have existing installers that are either no longer in development, or you don't own the source code. If you do own the source code, check out these docs on how to generate an MSIX from source code.
This section of documentation will show you how to set up your conversion environment, how to acquire and set up the MSIX Packaging Tool to set yourself up for success, and how to use the MSIX Packaging Tool to take any installer you have and convert it to MSIX. Once you've got an MSIX, we've also got information on how to fix runtime issues using the Package Support Framework.
How to move your existing installers to MSIX
When preparing to convert you application to MSIX, we recommend going through the following process to ensure that you get a clean MSIX package that is ready to be deployed. Before starting any of these steps, you may want to first evaluate your installer to ensure it will be supported in MSIX format.
Prepare your environment
There are several ways to set up your environment for conversion. Start with the best practices for our recommendations.
- Best practices for setting up a conversion environment
- How to get a Quick Create VM
- Setting up your machine for remote conversions
- Using the MSIX Packaging Tool in a disconnected environment
Set up your conversion tool and settings
- MSIX Packaging Tool Overview
- Best Practices for the MSIX Packaging Tool
- Known issues and troubleshooting tips for the MSIX Packaging Tool
- Duplicate MSIX Packaging Tool settings across devices
- MSIX Packaging Tool Insider Program
- Release notes for the MSIX Packaging Tool
Using the MSIX Packaging tool
- Create an MSIX package from a desktop installer (msi, exe, ClickOnce, or App-V)
- Conversion with the command line
- Support for desktop installers that require device restarts
- Convert an installer that includes services
- Modify a package using Package Editor
- Edit icons and assets using the MSIX Packaging Tool
Applying runtime fixes with the Packaging Support Framework
- Package Support Framework Overview
- Fix issues that prevent your desktop application from running in an MSIX container
- Run scripts with the Package Support Framework
Once you've got your MSIX package, you will be ready to move on to testing and validation of your application.