From 15f8f4594de812d538a12f023364c2fa67a2a7b0 Mon Sep 17 00:00:00 2001 From: MikeBlodge Date: Thu, 2 Aug 2018 10:46:40 -0700 Subject: [PATCH 1/6] updating --- .../msix-app-ackaging-tool.md | 64 +++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 windows/application-management/msix-app-ackaging-tool.md diff --git a/windows/application-management/msix-app-ackaging-tool.md b/windows/application-management/msix-app-ackaging-tool.md new file mode 100644 index 0000000000..f380710a6e --- /dev/null +++ b/windows/application-management/msix-app-ackaging-tool.md @@ -0,0 +1,64 @@ +--- +title: Repackage your existing win32 applications to the MSIX format. +description: Learn how to install and use the MSIX packaging tool. +keyboards: ["MSIX", "application", "app", "win32", "packaging tool"] +ms.prod: w10 +ms.mktglfcycl: manage +ms.sitesec: library +ms.localizationpriority: medium +ms.author: mikeblodge +ms.topic: article +ms.date: 08/01/2018 +--- + +# Repackage existing win32 applications to the MSIX format + +The MSIX Packaging Tool (Preview) is now available to install from the Microsoft Store. The MSIX Packaging Tool enables you to repackage your existing win32 applications to the MSIX format. You can run your desktop installers through this tool interactively and obtain an MSIX package that you can install on your machine and upload to the Microsoft Store (coming soon). + +> Prerequisites: +- Participation in the Windows Insider Program +- Minimum Windows 10 build 17701 +- Admin privileges on your PC account +- A valid MSA alias (to access the app from the Store) + +## What's new +- Moved "Send Feedback" to a top-level page in settings for better visibility. +- "Settings" saves now persist across app launches. +- All pop ups now have a uniform size. + + +## Installing the MSIX Packaging Tool + +1. Use the MSA login associated with your Windows Insider Program credentials in the [Microsoft Store](https://www.microsoft.com/store/r/9N5LW3JBCXKF). +2. Open the product description page. +3. Click the install icon to begin installation. + +This is an early preview build and not all features are supported. Here is what you can expect to be able to do with this preview: + +- Package your favorite application installer interactively (msi, exe, App-V 5.x and ClickOnce) to MSIX format by launching the tool and selecting **Application package** icon. +- Create a modification package for a newly created Application MSIX Package by launching the tool and selecting the **Modification package** icon. +- Open your MSIX package to view and edit its content/properties by navigating to the **Open package editor** tab. Browse to the MSIX package and select **Open package**. + +Features not supported in the tool are currently greyed out. Here are some of the highlighted missing features: + +- Some options in the Settings page, such as adding/removing VFS/VREG and defining a default save location. +- Package Support Framework integration. For more detail on how you can use Package Support Framework today, check out the article posted on the [MSIX blog](https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2FMSIX-Blog%2FMSIX-Package-Support-Framework-is-now-available-on-GitHub%2Fba-p%2F214548&data=02%7C01%7Cpezan%40microsoft.com%7Cbe2761c174cd465136ce08d5f1252d8a%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C636680064344941094&sdata=uW3oOOEYQxd0iVgsJkZXZTQwlvf%2FimVCaOdFUXcRoeY%3D&reserved=0). +- Packaging on existing virtual machines. You can still install the Tool on a fresh VM, but the tool cannot currently spawn off a conversion from a local machine to an existing VM. +- Command Line Interface support +- Conversion of App-V 4.x packages + +## How to file feedback + +Open Feedback Hub. Alternatively, launch the tool and select the **Settings** gear icon in the top right corner to open the Feedback tab. Here you can file feedback for suggestions, problems, and see other feedback items. + +## Best practices + +- When Packaging ClickOnce installers, it is necessary to send a shortcut to the desktop if the installer is not doing so already. In general, it's a good practice to always send a shortcut to your desktop for the main app executable. +- When creating modification packages, you need to declare the **Package Name** (Identity Name) of the parent application in the tool UI so that the tool sets the correct package dependency in the manifest of the modification package. +- Declaring an installation location field on the Package information page is optional but *recommended*. Make sure that this path matches the installation location of application Installer. +- Performing the preparation steps on the **Prepare Computer** page is optional but *highly recommended*. + +## Known bugs +1. Signing the package with Password protected certificates does not work. Please use a non-password protected password in the tool, or use Signtool (available from SDK) to sign your package for sideload testing. +2. You cannot edit the manifest manually from within the tool. (edit manifest button is disabled). Please use the SDK tools to unpack the MSIX package to edit the manifest manually. + From 78ee22dd58906b408798465633f9aa9c0332a91a Mon Sep 17 00:00:00 2001 From: MikeBlodge Date: Thu, 2 Aug 2018 15:03:05 -0700 Subject: [PATCH 2/6] updating --- .../{msix-app-ackaging-tool.md => msix-app-packaging-tool.md} | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) rename windows/application-management/{msix-app-ackaging-tool.md => msix-app-packaging-tool.md} (99%) diff --git a/windows/application-management/msix-app-ackaging-tool.md b/windows/application-management/msix-app-packaging-tool.md similarity index 99% rename from windows/application-management/msix-app-ackaging-tool.md rename to windows/application-management/msix-app-packaging-tool.md index f380710a6e..6e5fdc953a 100644 --- a/windows/application-management/msix-app-ackaging-tool.md +++ b/windows/application-management/msix-app-packaging-tool.md @@ -16,6 +16,7 @@ ms.date: 08/01/2018 The MSIX Packaging Tool (Preview) is now available to install from the Microsoft Store. The MSIX Packaging Tool enables you to repackage your existing win32 applications to the MSIX format. You can run your desktop installers through this tool interactively and obtain an MSIX package that you can install on your machine and upload to the Microsoft Store (coming soon). > Prerequisites: + - Participation in the Windows Insider Program - Minimum Windows 10 build 17701 - Admin privileges on your PC account @@ -58,7 +59,7 @@ Open Feedback Hub. Alternatively, launch the tool and select the **Settings** ge - Declaring an installation location field on the Package information page is optional but *recommended*. Make sure that this path matches the installation location of application Installer. - Performing the preparation steps on the **Prepare Computer** page is optional but *highly recommended*. -## Known bugs +## Known issues 1. Signing the package with Password protected certificates does not work. Please use a non-password protected password in the tool, or use Signtool (available from SDK) to sign your package for sideload testing. 2. You cannot edit the manifest manually from within the tool. (edit manifest button is disabled). Please use the SDK tools to unpack the MSIX package to edit the manifest manually. From 634804869be912ecb98ade4a25d25f66f94c0d55 Mon Sep 17 00:00:00 2001 From: MikeBlodge Date: Thu, 2 Aug 2018 15:50:40 -0700 Subject: [PATCH 3/6] updating --- windows/application-management/msix-app-packaging-tool.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/windows/application-management/msix-app-packaging-tool.md b/windows/application-management/msix-app-packaging-tool.md index 6e5fdc953a..e48cb1bcec 100644 --- a/windows/application-management/msix-app-packaging-tool.md +++ b/windows/application-management/msix-app-packaging-tool.md @@ -25,6 +25,7 @@ The MSIX Packaging Tool (Preview) is now available to install from the Microsoft ## What's new - Moved "Send Feedback" to a top-level page in settings for better visibility. - "Settings" saves now persist across app launches. +- Changing default save location is now supported through Settings menu. - All pop ups now have a uniform size. @@ -60,6 +61,9 @@ Open Feedback Hub. Alternatively, launch the tool and select the **Settings** ge - Performing the preparation steps on the **Prepare Computer** page is optional but *highly recommended*. ## Known issues -1. Signing the package with Password protected certificates does not work. Please use a non-password protected password in the tool, or use Signtool (available from SDK) to sign your package for sideload testing. -2. You cannot edit the manifest manually from within the tool. (edit manifest button is disabled). Please use the SDK tools to unpack the MSIX package to edit the manifest manually. +1. MSIX Packaging Tool Driver will fail to install if Windows Insider flight ring settings do no match the OS build of the conversion environment. Navigate to Settings, Updates & Security, Windows Insider Program to make sure your Insider preview build settings do not need attention. If you see this message click on the Fix me button to log in again. You might have to go to Windows Update page and check for update before settings change takes effect. Then try to run the tool again to download the MSIX Packaging Tool driver. If you are still hitting issues, try changing your flight ring to Canary or Insider Fast, install the latest Windows updates and try again. +2. You cannot edit the manifest manually from within the tool. (edit manifest button is disabled). Please use the SDK tools to unpack the MSIX package to edit the manifest manually. +3. Restarting the machine during application installation is not supported. Please ignore the restart request if possible or pass an argument to the installer to not require a restart. +4. Signing the package with Password protected certificates does not work. Please use a non-password protected password in the tool, or use Signtool (available from SDK) to sign your package for sideload testing. + From 2ec008a9fc1259b5b6d94958e3edc14d83c0fffa Mon Sep 17 00:00:00 2001 From: MikeBlodge Date: Wed, 8 Aug 2018 07:55:27 -0700 Subject: [PATCH 4/6] editing what's new section --- .../msix-app-packaging-tool.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/windows/application-management/msix-app-packaging-tool.md b/windows/application-management/msix-app-packaging-tool.md index e48cb1bcec..861d510bc9 100644 --- a/windows/application-management/msix-app-packaging-tool.md +++ b/windows/application-management/msix-app-packaging-tool.md @@ -23,10 +23,14 @@ The MSIX Packaging Tool (Preview) is now available to install from the Microsoft - A valid MSA alias (to access the app from the Store) ## What's new -- Moved "Send Feedback" to a top-level page in settings for better visibility. -- "Settings" saves now persist across app launches. -- Changing default save location is now supported through Settings menu. -- All pop ups now have a uniform size. +v1.2018.807.0 +- Ability to add/edit/remove file and registry exclusion items is now supported in Settings menu. +- Fixed an issue where signing in with password protected certificates would fail in the tool. +- Fixed an issue where the tool was crashing when editing an existing MSIX package. +- Fixed an issue where the tool was injecting whitespaces programmatically to install location paths that was causing conversion failures. +- Minor UI tweaks to add clarity. +- Minor updates to the logs for added clarity. + ## Installing the MSIX Packaging Tool @@ -43,7 +47,6 @@ This is an early preview build and not all features are supported. Here is what Features not supported in the tool are currently greyed out. Here are some of the highlighted missing features: -- Some options in the Settings page, such as adding/removing VFS/VREG and defining a default save location. - Package Support Framework integration. For more detail on how you can use Package Support Framework today, check out the article posted on the [MSIX blog](https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2FMSIX-Blog%2FMSIX-Package-Support-Framework-is-now-available-on-GitHub%2Fba-p%2F214548&data=02%7C01%7Cpezan%40microsoft.com%7Cbe2761c174cd465136ce08d5f1252d8a%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C636680064344941094&sdata=uW3oOOEYQxd0iVgsJkZXZTQwlvf%2FimVCaOdFUXcRoeY%3D&reserved=0). - Packaging on existing virtual machines. You can still install the Tool on a fresh VM, but the tool cannot currently spawn off a conversion from a local machine to an existing VM. - Command Line Interface support @@ -64,6 +67,5 @@ Open Feedback Hub. Alternatively, launch the tool and select the **Settings** ge 1. MSIX Packaging Tool Driver will fail to install if Windows Insider flight ring settings do no match the OS build of the conversion environment. Navigate to Settings, Updates & Security, Windows Insider Program to make sure your Insider preview build settings do not need attention. If you see this message click on the Fix me button to log in again. You might have to go to Windows Update page and check for update before settings change takes effect. Then try to run the tool again to download the MSIX Packaging Tool driver. If you are still hitting issues, try changing your flight ring to Canary or Insider Fast, install the latest Windows updates and try again. 2. You cannot edit the manifest manually from within the tool. (edit manifest button is disabled). Please use the SDK tools to unpack the MSIX package to edit the manifest manually. 3. Restarting the machine during application installation is not supported. Please ignore the restart request if possible or pass an argument to the installer to not require a restart. -4. Signing the package with Password protected certificates does not work. Please use a non-password protected password in the tool, or use Signtool (available from SDK) to sign your package for sideload testing. From 28685c2c11c2f12eb39b2cc39b0c77cf775b1ac2 Mon Sep 17 00:00:00 2001 From: MikeBlodge Date: Wed, 8 Aug 2018 07:59:41 -0700 Subject: [PATCH 5/6] editing metadata --- windows/application-management/msix-app-packaging-tool.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/windows/application-management/msix-app-packaging-tool.md b/windows/application-management/msix-app-packaging-tool.md index 861d510bc9..75f8dc0b50 100644 --- a/windows/application-management/msix-app-packaging-tool.md +++ b/windows/application-management/msix-app-packaging-tool.md @@ -1,7 +1,7 @@ --- title: Repackage your existing win32 applications to the MSIX format. description: Learn how to install and use the MSIX packaging tool. -keyboards: ["MSIX", "application", "app", "win32", "packaging tool"] +keywords: ["MSIX", "application", "app", "win32", "packaging tool"] ms.prod: w10 ms.mktglfcycl: manage ms.sitesec: library From 6fd6d731e20c23aea4e7e3baf7f05f336f637d69 Mon Sep 17 00:00:00 2001 From: MikeBlodge Date: Wed, 8 Aug 2018 08:02:30 -0700 Subject: [PATCH 6/6] edited toc to add msix page --- windows/application-management/TOC.md | 1 + 1 file changed, 1 insertion(+) diff --git a/windows/application-management/TOC.md b/windows/application-management/TOC.md index e726c4d38f..b3f1796488 100644 --- a/windows/application-management/TOC.md +++ b/windows/application-management/TOC.md @@ -4,6 +4,7 @@ ## [Enable or block Windows Mixed Reality apps in the enterprise](manage-windows-mixed-reality.md) ## [Understand apps in Windows 10](apps-in-windows-10.md) ## [Add apps and features in Windows 10](add-apps-and-features.md) +### [Repackage win32 apps in the MSIX format](msix-app-packaging-tool.md) ## [Application Virtualization (App-V) for Windows](app-v/appv-for-windows.md) ### [Getting Started with App-V](app-v/appv-getting-started.md) #### [What's new in App-V for Windows 10, version 1703 and earlier](app-v/appv-about-appv.md)