You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: hub/apps/distribute-through-store/how-to-distribute-your-win32-app-through-microsoft-store.md
+13-10Lines changed: 13 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
description: This section will guide you on how to distribute your Win32 application through Microrosft Store.
3
3
title: How to distribute your Win32 application through Microrosft Store.
4
-
ms.date: 02/12/2024
4
+
ms.date: 02/15/2024
5
5
ms.topic: article
6
6
ms.localizationpriority: medium
7
7
---
@@ -10,13 +10,13 @@ ms.localizationpriority: medium
10
10
11
11
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.
12
12
13
-
<br>
13
+
14
14
15
15
## Create a Partner Center account
16
16
17
17
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.
18
18
19
-
<br>
19
+
20
20
21
21
## Distribution options – Select the one that works best for you!
22
22
@@ -26,34 +26,37 @@ When you are distributing your Win32 app — which may be built using a variety
26
26
Streamline the user experience in discovery, acquisition, and installation by packaging your Win32 app as an MSIX using Desktop Bridge.
27
27
28
28
### 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
+
30
30
31
31
#### Refer to the table below for a comprehensive comparison of these two methods.
| Hosting | Complimentary, provided by Microsoft. | Publishers are responsible for hosting and associated costs. |
36
36
| 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. |
38
38
| Auto-Updates | The OS will automatically check updates every 24 hours. | The application is responsible for managing its own auto-updates. |
39
39
| S-Mode Support | Supported. | Not Supported. |
40
40
| Publish as Private Application | Available. | Not Available. |
41
41
| Package Flighting | Available. | Not Available. |
42
42
| Advanced Integration with Windows (e.g., Share dialog, Launch from the Store, ...) | Yes. | No. |
43
43
| 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. |
44
44
45
-
</br>
45
+
46
46
47
47
#### Let's explore each of these options in more detail in the following sections.
48
48
49
49
### Option 1 - Package your Win32 app as MSIX
50
50
51
51
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).
55
52
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).
57
60
58
61
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.
Copy file name to clipboardExpand all lines: hub/apps/distribute-through-store/how-to-transition-users-from-your-web-unpackaged-app-to-store-packaged-app.md
+28-19Lines changed: 28 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
description: This section will guide you on how to transition users from your web unpackaged app to Store packaged app.
3
3
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
5
5
ms.topic: article
6
6
ms.localizationpriority: medium
7
7
---
@@ -118,7 +118,7 @@ Subsequently, you can use the following code to silently download and install th
118
118
}
119
119
```
120
120
121
-
<br>
121
+
122
122
123
123
### How to launch the Store application from your web unpackaged app
@@ -130,50 +130,59 @@ To launch a Store application, it is necessary to know its AMUID, which consists
130
130
);
131
131
```
132
132
133
-
<br>
133
+
134
134
135
135
### How to detect iftheStorepackagedversionisinstalledandlaunchit
136
136
137
-
Youcandeterminewhetheryourpackagedversionoftheapplicationisinstalledbyusingthe [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.
Packagedapplicationshavetheirreservedspacefordatastorage, whichisautomaticallydeleted 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.
Packagedapplicationshavetheirreservedspacefordatastorage, whichisautomaticallydeleted 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
+
155
164
156
165
### How to migrate acquisitions and in-app purchases
157
166
#### In-app purchases
158
167
Toguaranteeanoptimaluserexperience, itisessentialthatuserscanseamlesslyaccesscontenttheyhavepurchasedintheunpackagedversionofyourapplication. Withthisobjective, theMicrosoftStorehasincreaseditsflexibilityforpublishersbypermittingtheuseoftheirownorthird-partycommerceplatformsinadditiontoMicrosoft's since June 2021.
Simplylistthe [programmaticidentifiers](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.
0 commit comments