Skip to content

Commit 26cac76

Browse files
Update links (#4090)
* Update links * Update links
1 parent 13f30c3 commit 26cac76

File tree

2 files changed

+41
-29
lines changed

2 files changed

+41
-29
lines changed

hub/apps/distribute-through-store/how-to-distribute-your-win32-app-through-microsoft-store.md

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: This section will guide you on how to distribute your Win32 application through Microrosft Store.
33
title: How to distribute your Win32 application through Microrosft Store.
4-
ms.date: 02/12/2024
4+
ms.date: 02/15/2024
55
ms.topic: article
66
ms.localizationpriority: medium
77
---
@@ -10,13 +10,13 @@ ms.localizationpriority: medium
1010

1111
This article guides you on a smooth onboarding process, various distribution options, recommended best practices, and scenarios to consider when distributing your app via the Store, to ensure a better customer experience.
1212

13-
<br>
13+
1414

1515
## Create a Partner Center account
1616

1717
You must have a [Partner Center account](https://partner.microsoft.com/dashboard/) to submit an app to the Store. If you don’t have an account, follow these [steps](../publish/partner-center/partner-center-developer-account.md) for account creation and then follow these [steps](../publish/publish-your-app/overview.md) to effortlessly introduce your application to the Store.
1818

19-
<br>
19+
2020

2121
## Distribution options – Select the one that works best for you!
2222

@@ -26,34 +26,37 @@ When you are distributing your Win32 app — which may be built using a variety
2626
Streamline the user experience in discovery, acquisition, and installation by packaging your Win32 app as an MSIX using Desktop Bridge.
2727

2828
### List your existing EXE or MSI from your website</h2> List your Win32 app in its original form in the Microsoft Store.
29-
</br>
29+
3030

3131
#### Refer to the table below for a comprehensive comparison of these two methods.
3232

3333
| Feature | Packaged (MSIX) | Unpackaged (Win32) |
3434
| ----------- | ----------- | ----------- |
3535
| Hosting | Complimentary, provided by Microsoft. | Publishers are responsible for hosting and associated costs. |
3636
| Commerce Platform (payment, in-apps, subscriptions, licensing) | Use Microsoft Store commerce platform or your own or 3P commerce platform. | Use your own or 3P commerce platform. |
37-
| Code signing | Complimentary, provided by Microsoft. | Publishers must sign with a certificate issued by a Certificate Authority (CA) that is part of the [Microsoft Trusted Root Program](https://learn.microsoft.com/security/trusted-root/participants-list) and cover associated costs. |
37+
| Code signing | Complimentary, provided by Microsoft. | Publishers must sign with a certificate issued by a Certificate Authority (CA) that is part of the [Microsoft Trusted Root Program](/security/trusted-root/participants-list) and cover associated costs. |
3838
| Auto-Updates | The OS will automatically check updates every 24 hours. | The application is responsible for managing its own auto-updates. |
3939
| S-Mode Support | Supported. | Not Supported. |
4040
| Publish as Private Application | Available. | Not Available. |
4141
| Package Flighting | Available. | Not Available. |
4242
| Advanced Integration with Windows (e.g., Share dialog, Launch from the Store, ...) | Yes. | No. |
4343
| Windows 11 backup and restore feature | Can be automatically installed when users are restoring or migrating a device. | Start Menu icons will be restored but will point to the Microsoft Store product page. |
4444

45-
</br>
45+
4646

4747
#### Let's explore each of these options in more detail in the following sections.
4848

4949
### Option 1 - Package your Win32 app as MSIX
5050

5151
Package your application into a MSIX is very simple, you can either use:
52-
1. Visual Studio by adding the project Windows Application Packaging to your solution. See documentation [here](https://learn.microsoft.com/windows/msix/desktop/desktop-to-uwp-packaging-dot-net).
53-
2. Use installer solutions from one of our partners: See list [here](https://learn.microsoft.com/windows/msix/desktop/desktop-to-uwp-third-party-installer).
54-
3. Microsoft MSIX Packaging Tool to create the MSIX from an existing installer. See documentation [here](https://learn.microsoft.com/windows/msix/packaging-tool/create-app-package).
5552

56-
You can verify the compliance of your MSIX with the Microsoft Store by utilizing the Windows App Certification Kit and following these [instructions](https://learn.microsoft.com/windows/uwp/debug-test-perf/windows-app-certification-kit).
53+
1. Visual Studio by adding the project Windows Application Packaging to your solution. See [Set up your desktop application for MSIX packaging in Visual Studio](/windows/msix/desktop/desktop-to-uwp-packaging-dot-net).
54+
55+
1. Use installer solutions from one of our partners. See [Package a desktop app using third-party installers](/windows/msix/desktop/desktop-to-uwp-third-party-installer).
56+
57+
1. Microsoft MSIX Packaging Tool to create the MSIX from an existing installer. See [Create an MSIX package from any desktop installer (MSI, EXE, ClickOnce, or App-V)](/windows/msix/packaging-tool/create-app-package).
58+
59+
You can verify the compliance of your MSIX with the Microsoft Store by utilizing the [Windows App Certification Kit instructions](/windows/uwp/debug-test-perf/windows-app-certification-kit).
5760

5861
If your application was previously distributed on the web or if you intend to distribute it on the web as well, you can discover recommendations on how to migrate users from the web application to the Store version here.
5962

hub/apps/distribute-through-store/how-to-transition-users-from-your-web-unpackaged-app-to-store-packaged-app.md

Lines changed: 28 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: This section will guide you on how to transition users from your web unpackaged app to Store packaged app.
33
title: How to transition users from your web unpackaged app to Store packaged app.
4-
ms.date: 02/12/2024
4+
ms.date: 02/15/2024
55
ms.topic: article
66
ms.localizationpriority: medium
77
---
@@ -118,7 +118,7 @@ Subsequently, you can use the following code to silently download and install th
118118
}
119119
```
120120

121-
<br>
121+
122122

123123
### How to launch the Store application from your web unpackaged app
124124
To launch a Store application, it is necessary to know its AMUID, which consists of the Package Family Name (found in the "Product Identity" section of the Partner Center) and the Application Id (from your appxmanifest), separated by an exclamation mark (!).
@@ -130,50 +130,59 @@ To launch a Store application, it is necessary to know its AMUID, which consists
130130
);
131131
```
132132

133-
<br>
133+
134134

135135
### How to detect if the Store packaged version is installed and launch it
136136

137-
You can determine whether your packaged version of the application is installed by using the [GetPackagesByPackageFamily](https://learn.microsoft.com/windows/win32/api/appmodel/nf-appmodel-getpackagesbypackagefamily) win32 API and passing in the Package Family Name of your packaged app. If the count value is higher than zero, it indicates that the application is installed.
138-
<br>
137+
You can determine whether your packaged version of the application is installed by using the [GetPackagesByPackageFamily](/windows/win32/api/appmodel/nf-appmodel-getpackagesbypackagefamily) win32 API and passing in the Package Family Name of your packaged app. If the count value is higher than zero, it indicates that the application is installed.
138+
139139

140140
### How to uninstall your web unpackaged application from the packaged one
141141

142142
To retrieve the absolute path of your uninstaller, you can access the registry.
143143

144144
Your uninstaller information is located in the registry at:
145-
HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\<your product code GUID\>.
145+
146+
```
147+
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\<your product code GUID\>
148+
```
146149

147150
Retrieve the full command in the `UninstallString` value and execute it.
148151
It is recommended to either perform the uninstallation silently or inform the user that you are migrating data and uninstalling the other application.
149-
<br>
152+
150153

151154
### How to migrate data
152-
Your unpackaged application likely stores its local data in %localAppData%/\<YourPublisherName\>/\<YourAppName\>.
153-
Packaged applications have their reserved space for data storage, which is automatically deleted when the application is uninstalled. It is highly recommended (though not mandatory) to migrate the data to this space upon the first launch. You can retrieve the absolute path of this folder by calling Windows.Storage.ApplicationData.Current.LocalFolder.Path.
154-
<br>
155+
Your unpackaged application likely stores its local data in:
156+
157+
```
158+
%localAppData%/<YourPublisherName\>/<YourAppName\>
159+
```
160+
161+
162+
Packaged applications have their reserved space for data storage, which is automatically deleted when the application is uninstalled. It is highly recommended (though not mandatory) to migrate the data to this space upon the first launch. You can retrieve the absolute path of this folder by calling [Windows.Storage.ApplicationData.Current.LocalFolder.Path](/uwp/api/windows.storage.applicationdata.localfolder?view=winrt-22621).
163+
155164

156165
### How to migrate acquisitions and in-app purchases
157166
#### In-app purchases
158167
To guarantee an optimal user experience, it is essential that users can seamlessly access content they have purchased in the unpackaged version of your application. With this objective, the Microsoft Store has increased its flexibility for publishers by permitting the use of their own or third-party commerce platforms in addition to Microsoft's since June 2021.
159-
<br>
168+
160169

161170
We strongly encourage publishers to continue verifying in-app purchase entitlements as performed in the unpackaged version of their application in addition to integrate with the Microsoft Commerce platform to enable users to effortlessly purchase your content with just a few clicks on Windows.
162-
<br>
171+
163172

164173
#### Allow paid users of the unpackaged application to migrate to the packaged version
165174
If users have purchased your product on your website, they should not have to pay again to download the packaged version from the Store.
166175
To ensure a seamless transition, we recommend the following approaches:
167176

168177
1. Offer a free/demo version of your product, allowing users to unlock the full version through in-app purchases. For users who have already paid on your website, enable them to access the full version by signing in to verify their licenses or by entering their license key in the application's user interface.
169-
2. Set your application as a paid offering but distribute coupon code to your existing users through your own channels. These codes will allow them to download the Store version at no additional cost. More information can be found [here](https://learn.microsoft.com/windows/apps/publish/generate-promotional-codes).
170-
<br>
178+
2. Set your application as a paid offering but distribute coupon code to your existing users through your own channels. These codes will allow them to download the Store version at no additional cost. More information can be found in [Generate promotional codes](/windows/apps/publish/generate-promotional-codes).
179+
171180

172181
### How to migrate existing pinned taskbar and Start Menu shortcuts
173182
Your users may have pinned your desktop application to the taskbar or the Start menu. You can direct these shortcuts to your new packaged app by including the "windows.desktopAppMigration" extension in your application manifest.
174-
<br>
175183

176-
#### Example:
184+
185+
#### Example
177186

178187
```csharp
179188
xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
@@ -189,12 +198,12 @@ xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/r
189198
</rescap3:Extension>
190199
</Extensions>
191200
```
192-
<br>\
201+
193202
After installing your application, the pins in the taskbar or in the Start menu, as well as the tiles (for Windows 10) will launch automatically the Store application.
194203

195204
### How to migrate file extension & protocol associations
196205
If your application supports file extension or protocol associations and users have selected your app as the default application for specific file extensions and protocols, you have the option to migrate these associations to your Store packaged application. This migration can be achieved by updating your app manifest with the following code snippet.
197-
<br>
206+
198207
```code
199208
xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
200209
...
@@ -210,4 +219,4 @@ xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/r
210219
</Extensions>
211220
```
212221

213-
Simply list the [programmatic identifiers](https://learn.microsoft.com/windows/win32/shell/fa-progids?redirectedfrom=MSDN) you want to migrate to and the system will automatically migrate them to your application after installation.
222+
Simply list the [programmatic identifiers](/windows/win32/shell/fa-progids) to which you want to migrate, and the system will automatically migrate them to your application after installation.

0 commit comments

Comments
 (0)