Skip to content

Commit 25c6e70

Browse files
lilybarkley-msftmacruzcoddsilva-msft
authored
Addressing some feedback from BugBash (#8)
* Addressing some feedback from bugbash * added line breaks and a link to the download * fix Win32 app isolation capitalization * Update docs/packaging/msix-packaging-tool.md Co-authored-by: Dylan DSilva <83655835+ddsilva-msft@users.noreply.github.com> * changing link * Update docs/packaging/msix-packaging-tool.md Co-authored-by: macruzco <93291474+macruzco@users.noreply.github.com> * Update docs/packaging/msix-packaging-tool.md Co-authored-by: macruzco <93291474+macruzco@users.noreply.github.com> --------- Co-authored-by: macruzco <93291474+macruzco@users.noreply.github.com> Co-authored-by: Dylan DSilva <83655835+ddsilva-msft@users.noreply.github.com>
1 parent 10c6e15 commit 25c6e70

File tree

1 file changed

+20
-10
lines changed

1 file changed

+20
-10
lines changed

docs/packaging/msix-packaging-tool.md

Lines changed: 20 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,23 @@
11
# Table of Contents
2-
1. [Convert an existing win32 installer into an .msix app](#Win32)
3-
2. [Convert an existing .msix app to run isolated](#MSIX)
2+
1. [Convert an existing win32 installer into an .msix app](#Win32-->-msix)
3+
2. [Convert an existing .msix app to run isolated](#MSIX-->-Isolated-Win32)
44

55
## Overview
66

77
This page will cover everything needed to package an existing MSIX or win32 application into
8-
Isolated Win32 App. This will be done through the MSIX Packaging Tool (MPT). **Note** that the version of MPT that supports Win32 App Isolation is v1.2023.517.0, available in the release assets of this project. The [store version of MPT](https://learn.microsoft.com/en-us/windows/msix/packaging-tool/tool-overview) is **outdated** for the purposes of the Win32 App Isolation feature.
8+
an isolated Win32 app. This will be done through the MSIX Packaging Tool (MPT). **Note** that the
9+
version of MPT that supports Win32 app isolation is v1.2023.517.0, available in the release assets
10+
of this project. The [store version of MPT](https://learn.microsoft.com/en-us/windows/msix/packaging-tool/tool-overview)
11+
is **outdated** for the purposes of the Win32 app isolation feature. You can find additional
12+
documentation for MPT [here](https://learn.microsoft.com/en-us/windows/msix/packaging-tool/tool-overview).
913

10-
## Win32 -> MSIX <a name="Win32"></a>
14+
You can find the download for MPT, as well as the profiler, in the [releases](../../../../releases) section of the github.
1115

12-
1. Select "Application Pacakge" on the far left and choose where the package will be created.
13-
This flow will follow the "Create package on this computer" option.
16+
## Win32 -> MSIX
17+
18+
1. Select "Application Package" on the far left and choose where the package will be created.
19+
This flow will follow the "Create package on this computer" option. **Note** This will result
20+
in the app installed as a normal win32 after finishing step 5.
1421

1522
![image](https://github.com/microsoft/win32-app-isolation/blob/main/docs/packaging/images/01-packaging-main-menu.png)
1623

@@ -23,7 +30,7 @@ blank as we will need to edit the manifest and sign it again.
2330

2431
![image](https://github.com/microsoft/win32-app-isolation/blob/main/docs/packaging/images/03-packaging-installer.png)
2532

26-
4. Enter the package information. The publisher name must match the name on the certificate used to sign in later steps.
33+
4. Enter the package information.
2734

2835
![image](https://github.com/microsoft/win32-app-isolation/blob/main/docs/packaging/images/04-packaging-package-info.png)
2936

@@ -36,11 +43,13 @@ MSIX will pick up on them
3643
7. Repeat the same process if there are services in the package
3744

3845
8. Clicking Create will save the package as a full trust package. Click the "Package Editor" button
39-
to go to the "Package Editor" flow from the main menu
46+
to go to the "Package Editor" flow from the main menu. This can take up to several minutes depending
47+
on the size of the package.
4048

4149
![image](https://github.com/microsoft/win32-app-isolation/blob/main/docs/packaging/images/05-packaging-create-package.png)
4250

43-
## MSIX -> Isolated Win32 <a name="MSIX"></a>
51+
## MSIX -> Isolated Win32
52+
4453
1. Select the far right option "Application Pacakge" and browse to the .msix file and click the
4554
"Open package" button.
4655

@@ -84,7 +93,8 @@ to go to the "Package Editor" flow from the main menu
8493
* `isolatedWin32-volumeRootMinimal`
8594

8695
4. Save and close the manifest window. If there are any errors in the manifest, MPT will display
87-
them. Select Create/Save to generate the .msix file.
96+
them. Select Create/Save to generate the .msix file. This can take serveral minutes depending on
97+
the size of the package
8898

8999
5. See [application capability profiler](../profiler/application-capability-profiler.md) for
90100
information on identifying capabilities that may need to be declared in the application package

0 commit comments

Comments
 (0)