Skip to content

Commit ec536c1

Browse files
Fixing win32 app submission docs (#4092)
* Delete hub/includes/store/msi/images/msiexe-packages-overview.png * Add files via upload * Add files via upload * Win32 doc updates * Fixing links * Fixing additional links * Additional content fixes * Add files via upload * Added more screenshots * fixing image url * image url fix 2 * Fixing content * Update app-package-requirements.md
1 parent f1f890a commit ec536c1

36 files changed

+254
-86
lines changed

hub/apps/publish/partner-center/manage-app-name-reservations.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.localizationpriority: medium
88

99
# Manage app name reservations
1010

11-
The **Manage app names** page in Partner Center lets you view all of the names that you've reserved for your app, reserve additional names (for other languages or to change your app's name), and delete names you don't need. You can find this page in [Partner Center](https://partner.microsoft.com/dashboard) by expanding the **App management** section in the left navigation menu for any of your apps.
11+
The **Manage app names** page in Partner Center lets you view all of the names that you've reserved for your app, reserve additional names (for other languages or to change your app's name), and delete names you don't need. You can find this page in [Partner Center](https://partner.microsoft.com/dashboard) by expanding the **Product management** section in the left navigation menu for any of your apps.
1212

1313
:::image type="content" source="../images/manage-app-name.png" lightbox="../images/manage-app-name.png" alt-text="A screenshot of the Manage app name page on Partner Center.":::
1414

hub/apps/publish/publish-your-app/create-app-submission.md

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,18 @@ Once you've [created your app by reserving a name](reserve-your-apps-name.md), y
1515

1616
You can start your submission when your app is complete and ready to publish, or you can start entering info before you have written a single line of code. Updates you make to your submission are saved, so you can come back and work on it whenever you're ready.
1717

18+
:::zone pivot="store-installer-msix,store-installer-pwa"
19+
1820
After your app is published, you can publish an updated version by creating another submission in Partner Center. Creating a new submission lets you make and publish whatever changes are needed, whether you're uploading new packages or just changing details such as price or category. To create a new submission for a published app, click **Update** next to the most recent submission shown on its **Overview** page.
1921

22+
:::zone-end
23+
24+
:::zone pivot="store-installer-msi-exe"
25+
26+
You can make changes to a published app at any time. To submit updates, go to the application's overview page in Partner Center. Navigate to the update app section. An update submission has already been created using the info from your previous submission as a starting point. You can add a new package or update any of the information like pricing model, listing details etc.
27+
28+
:::zone-end
29+
2030
:::zone pivot="store-installer-msix,store-installer-pwa,store-installer-msi-exe"
2131

2232
## App submission checklist
@@ -62,14 +72,20 @@ After you select **Create a new add-on**, you'll be prompted to specify a produc
6272
> [!IMPORTANT]
6373
> To ensure that you receive critical email notifications, you'll be required to verify your email address in Action Center. Go to [My Preferences](https://partner.microsoft.com/dashboard/actioncenter/mypreferences) in Action Center to verify.
6474
65-
After publishing an app, the [owner](../partner-center/assign-account-level-custom-permissions-to-account-users.md) of your developer account is always notified of the publishing status and required actions through email and the [Action Center](/partner-center/action-center-overview) in Partner Center. In addition, you can add members in either **developer** or **manager** role within your developer account to receive same notifications or remove those who no longer need be notified.
75+
After publishing an app, the [owner](../partner-center/assign-account-level-custom-permissions-to-account-users.md) of your developer account is always notified of the publishing status and required actions through email and the [Action Center](/partner-center/action-center-overview) in Partner Center.
76+
77+
:::zone pivot="store-installer-msix,store-installer-pwa"
78+
79+
In addition, you can add members in either **developer** or **manager** role within your developer account to receive same notifications or remove those who no longer need be notified.
6680

6781
To add or remove:
6882
1. On the Submission options page, look for the field of “Submission notification audience”
69-
1. Click “Click here” to open Notification audience overview page
70-
1. On the Notification audience overview page, add or remove audience
83+
2. Click “Click here” to open Notification audience overview page
84+
3. On the Notification audience overview page, add or remove audience
7185

7286
> [!NOTE]
7387
> - The owner of your developer account is always notified and can’t be removed from the audience list.
7488
> - The audience list is product specific and applied to all submissions of the product. To modify the notification recipients for a different product, follow the steps above for each product.
7589
> - Add-on inherits parent product’s audience list and can’t be managed separately.
90+
91+
:::zone-end

hub/apps/publish/publish-your-app/market-selection.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,6 @@ zone_pivot_groups: store-installer-packaging
99

1010
# Define market selection
1111

12-
The Microsoft Store reaches customers in over 200 countries and regions around the world. You can choose the markets in which you'd like to offer your app, with the option to customize many [pricing and availability](price-and-availability.md) features per market or per group of markets.
13-
14-
For info to help make your app suitable for customers around the world, see [Guidelines for globalization](../../design/globalizing/guidelines-and-checklist-for-globalizing-your-app.md) and [Make your app localizable](../../design/globalizing/prepare-your-app-for-localization.md).
15-
1612
:::zone pivot="store-installer-msix,store-installer-pwa,store-installer-add-on"
1713
[!INCLUDE [name](../../../includes/store/msix/market-selection.md)]
1814
:::zone-end

hub/apps/publish/publish-your-app/reserve-your-apps-name.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,14 @@ Follow the following steps to reserve your app's name:
3030
2. MSI or EXE app publishing experience is only available in the new Workspace interface and you can click the “Workspaces” button on the top right of the page to toggle to the new interface. For more information, see [Partner Center Workspaces](../partner-center/partner-center-workspaces.md)
3131
3. Navigate to the [Partner Center apps and games page](https://partner.microsoft.com/dashboard/apps-and-games/overview).
3232
4. Click **New product**.
33-
5. Choose your app's type.
33+
5. Click on EXE or MSI app.
34+
35+
:::image type="content" source="../../../includes/store/msi/images/msiexe-new-product.png" lightbox="../../../includes/store/msi/images/msiexe-new-product.png" alt-text="A screenshot showing how to create an EXE/MSI app.":::
36+
3437
6. Enter the name you'd like to use and click **Check availability**. If the name is available, you'll see a green check mark. If the name is already in use, you'll see a message indicating so.
38+
39+
:::image type="content" source="../../../includes/store/msi/images/msiexe-app-name-reservation-page.png" lightbox="../../../includes/store/msi/images/msiexe-app-name-reservation-page.png" alt-text="A screenshot showing how to reserve a name for EXE/MSI app.":::
40+
3541
7. Once you've selected an available name that you'd like to reserve, click **Reserve product name**.
3642
:::zone-end
3743

hub/apps/publish/publish-your-app/visibility-options.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,7 @@ ms.localizationpriority: medium
77
zone_pivot_groups: store-installer-packaging
88
---
99

10-
# Choose visibility options
11-
12-
The **Visibility** section of the [Pricing and availability page](price-and-availability.md) allows you to set restrictions on how your app can be discovered and acquired. This gives you the option to specify whether people can find your app in the Store or see its Store listing at all.
10+
# Choose visibility or discoverability options
1311

1412
:::zone pivot="store-installer-msix,store-installer-pwa,store-installer-add-on"
1513
[!INCLUDE [name](../../../includes/store/msix/visibility-options.md)]

hub/apps/toc.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,7 @@ items:
138138
items:
139139
- name: Define market selection
140140
href: publish/publish-your-app/market-selection.md
141-
- name: Choose visibility options
141+
- name: Choose visibility or discoverability options
142142
href: publish/publish-your-app/visibility-options.md
143143
- name: Configure precise release scheduling
144144
href: publish/publish-your-app/release-schedule.md
@@ -160,6 +160,8 @@ items:
160160
- name: Upload app packages
161161
href: publish/publish-your-app/upload-app-packages.md
162162
items:
163+
- name: Package validation
164+
href: publish/publish-your-app/package-validation-pre-check.md
163165
- name: Device family availability
164166
href: publish/publish-your-app/device-families.md
165167
- name: App package requirements
@@ -199,8 +201,6 @@ items:
199201
items:
200202
- name: The app certification process
201203
href: publish/publish-your-app/app-certification-process.md
202-
- name: Package validation
203-
href: publish/publish-your-app/package-validation-pre-check.md
204204
- name: Manual package validation
205205
href: publish/publish-your-app/manual-package-validation.md
206206
- name: Resolve submission errors

hub/includes/store/msi/add-and-edit-store-listing-info.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ See [App screenshots and images](../../../apps/publish/publish-your-app/screensh
4444

4545
### Store logos
4646

47-
Store logos are optional images that you can upload to enhance the way your app is displayed to customers.
47+
You can upload Store logos to create a more customized display in the Store.
4848

4949
See [App screenshots and images](../../../apps/publish/publish-your-app/screenshots-and-images.md) for more information.
5050

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
1-
> [!IMPORTANT]
2-
> App package management is not supported for MSI and EXE apps.
1+
You can bring different packages for different architectures and language(s). For a combination of a architecture and language(s), you can only bring one package. For example, you can only bring one package for x64 and 'English' language combination.
2+
3+
While updating your app, you can delete the previous packages by going to Manage Packages page. Delete the package which is not required anymore and add a new package if required. After deleting or adding a new package, click on 'Save all' on the Manage packages page. This will upload the new changes.
Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,13 @@
1-
> [!IMPORTANT]
2-
> App package requirements are not supported for MSI and EXE apps.
1+
Submit an HTTPS-enabled download URL (direct link) to the product’s installer binaries. Products submitted in this manner are subject to the following requirements:
2+
3+
- The installer binary may only be an .msi or .exe.
4+
5+
- The binary and all of its Portable Executable (PE) files must be digitally signed with a code signing certificate that chains up to a certificate issued by a Certificate Authority (CA) that is part of the [Microsoft Trusted Root Program](/security/trusted-root/participants-list).
6+
7+
- You must submit a versioned download URL in Partner Center. The binary associated with that URL must not change after submission.
8+
9+
- Whenever you have an updated binary to distribute, you must provide an updated versioned download URL in Partner Center associated with the updated binary. You are responsible for maintaining and updating the download URL.
10+
11+
- Initiating the install must not display an installation user interface (i.e., silent install is required), however a User Account Control (UAC) dialog is allowed.
12+
13+
- The installer is a standalone installer and is not a downloader stub/web installer that downloads bits when run.

hub/includes/store/msi/app-submission-control.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,9 @@ To delete a draft submission, follow these steps:
1212

1313
1. Go to the Apps and Games overview page and open the app you want to delete. You can only delete an app that is not submitted or live on the Store.
1414
2. On the Application overview page, click on the three dots on the top right corner of the App setup card. Select Delete from the menu.
15+
16+
:::image type="content" source="images/msiexe-delete-app.png" lightbox="images/msiexe-delete-app.png" alt-text="A screenshot showing how to delete an EXE/MSI app.":::
17+
1518
3. Confirm that you want to delete the app and all its information.
1619

1720
## Cancel review
@@ -24,4 +27,6 @@ To cancel a review process, follow these steps:
2427
- If you submitted a new app, navigate to the App setup card. Click on the three dots on the top right corner of the card. Select Cancel review from the menu.
2528
- If you submitted an app update, navigate to the Update app card. Click on the three dots. Select Cancel review from the menu.
2629

30+
:::image type="content" source="images/msiexe-cancel-review.png" lightbox="images/msiexe-cancel-review.png" alt-text="A screenshot showing how to cancel a review for an EXE/MSI app.":::
31+
2732
1. Confirm that you want to cancel the review process. It may take up to a minute for your app to go back to draft state.

0 commit comments

Comments
 (0)