Home

Welcome to the MSIX-Power-Wrapper wiki!

What is the MSIX-Power-Wrapper?

The MSIX-Power-Wrapper is a small exe tool that can be used to bootstrap the application launch in MSIX files. It provides several features to enhance the experience of repackaged desktop apps within an MSIX package.

How is the tool used?

You simply download the MSIX-Power-Wrapper EXE file and rename it to something that fits the use-case of your application. You then place an empty textfile with the same name as your EXE file (including the extension) and add the extension wrunconfig. This is your configuration for the wrapper and should be used to configure the bootstrap process. So a deployment may look like this:

• myappwrapper.exe
• myappwrapper.exe.wrunconfig The myappwrapper.exe will look out for the wrunconfig file and load it when it is present.

The wrunconfig files

The wrunconfig file is the configuration file of the wrapper and is written in XML. A configuration may look like this:

<config>
  <Process>
    <Filename>[APPDIR]\mymainapp.exe</Filename>
    <WorkingDirectory>[APPDIR]</WorkingDirectory>
    <UseShellExecute>true</UseShellExecute>
    <Arguments>myargument [ARGS]</Arguments>
  </Process>
  <AppInstallerUpdateHandler>
     <WaitForUpdateSearchToFinish>true</WaitForUpdateSearchToFinish>
     <TreatAvailableUpdateAsMandatory>true</TreatAvailableUpdateAsMandatory>
     <RestartOnMandatoryUpdate>true</RestartOnMandatoryUpdate>
     <Message lang="default" caption="Update">Die Anwendung muss aktualisiert werden. Bitte warten...</Message>
     <Message lang="en" caption="Update">The app needs to install an update. Please wait</Message>
  </AppInstallerUpdateHandler>
</config>

So each configuration starts with the config element and includes all the features you want to configure. In this case for example Process and AppInstallerUpdateHandler. It does not matter in which order you configure features.