How to publish your MSIX package to the Microsoft Store?
You have just made your MSIX application, and now you want to share it with the rest of the world. One of the best places to publish it is in Microsoft Store. Why?
- Automatic Digital Signing - MSIX requires digital signing and, by publishing it to the Store, your app gets signed automatically. Therefore you don’t need to buy a third-party CA (certification authority), and your app will have the credibility of being secure in case you use your own certification.
- Microsoft Store is a marketplace - You don’t need to create an e-commerce website properly configured so you can sell the app. A simple web-site where you present your product, will do it.
- Great Exposure - Microsoft Store has notoriety and has numerous users therefore you get exposure. Of course, you can advertise your published app to get more downloads and sales.
In this article, we will guide you on how to publish successfully an MSIX application by using our own app as an example: Hover.
Hover is a free tool developed by Advanced Installer’s team that allows you to run natively installed applications inside an MSIX/App-V container.Available to download here.
1. Get registered
To publish your app to the store, you need to have a developer account. Go to Microsoft Partner Center and sign up.
A normal Microsoft account is required to create the developer account. The log-in will be made using the same email address.
There is a one-time registration fee, and it depends on what type of account you are creating:
- 19$ for an individual account
- 99$ for a company account
For more information related to account differences and exact prices based on location, check out this link.
The sign-up process is straight-forward:
- Select Account country/region
- Choose Account type
- Enter your Publisher display name (Company Name)
- Fill in your Contact info
- Proceed to payment, review and finalize the sign-up process
2. Create your app (name reservation)
Now that you have your accounts created, it is time to log-in to Partner Center and navigate to Dashboard.
Once in the Overview section, it is time to "Create a new app".
"Create your app by reserving a name" is the step where you choose your application name. From the moment you reserve the product name, you have three months to submit your app to the Microsoft Store. Otherwise, you lose your name reservation.
3. Application overview
Once your application name is validated, you can see it by navigating to Overview from the left pane menu.
By clicking on the app name, you enter the Application overview page.
From here, you have many options to manage your application and additional features such as Add-ons, Analytics, Product Management, and Services.
What we are interested in doing right now is "Start your submission".
When you press the "Start your submission", a submission page is generated. Here are some subsections that you need to go through before you can actually hit the "Submit to the Store" button.
4.1 Pricing and availability
As the title suggests, this is the page where we set up how much the application will cost, how the release is handled and other available options.
Markets, Visibility, and Schedule are left as default.
As for the Pricing of our app, we have set it to Free. There are other options that you can tweak when a price is fixed. Options such as Free trial, Sale pricing and Organizational licensing.
Properties configuration page contains the following subsections:
- Category and subcategory: We have set it as a Developer tools with no subcategory
- Support info:Our company information
- Display mode>:This is optional, based on your app
- Product declaration>:we only have 2 check declarations. This can vary on each app.
- System requirements>:This being a simple non-demanding app, we only marked Keyboard and Mouse. Feel free to complete any requirements you know your app needs.
4.3 Age rating
This page requires you to complete a questionnaire on IARC (International Age Rating Coalition). Since our application is not a Game, Social, or Communication, we chose All Other App Types category for the Rating questionnaire.
The Package section is the place where you upload the application, and you set the "Device family availability". In our example, we targeted Windows 10 Desktop, and we let the default mark "Let Microsoft decide...".
On our first upload, we found a little acceptance error while the application was verified.
"Package acceptance validation error: Hover-x64.msix is not valid. You cannot upload msix/msixbundle/msixupload packages that targets Windows MinVersion <= 10.0.17134.0 "
For that, we have used Advanced Installer to fix the error. We edited the project and limited the OS minimum requirement from our application project by going to Package Definition -> Builds.
When the app passed the validation, you should see the following screen:
4.5 Store listings.Manage Store listing languages
The first subsection in Store listing is "Languages supported in packages". After you upload your application to the store, during validation, the AppxManifest.xml file is checked for the supported language entries.
After the language is detected and displayed, you need to complete the store listing. As you can see in the above image, in the English section, the status is Incomplete.
In Additional Store listing homepages, you can add multiple store listings in different languages. This is the interface languages that users see in the store, not the supported languages detected within the actual MSIX package Appxmanifest.xml.
Note: To add additional support languages in your MSIX, using Advanced Installer you have to: 1. Go in the "Translations" page, "Languages" tab 2. Check the corresponding box for the desired language 3. Go to the "Project Strings" tab and double-click the rows under each language to translate them in those languages
The next thing to do is go to Submission 1 overview page and click on the English(United States) language, just below the Store listing. Notice the green marks on the previous steps that we have completed? That means we did a good job.
On the English language page, there are three mandatory fields: Product name, Description, and Screenshots. Feel free to complete the rest of the information for a more detailed description.
Remember: you need to complete this action for any additional language.
4.6 Submission Options
This section is not mandatory but recommended to be configured.
Publishing hold options allow you to decide when your application is published to the store. By default, after your Submission request is validated, your app is published automatically. But you also have the option to schedule the submission or manually publish it.
Notes for certification is a good text box where you can add additional information that could help up the validation process. Feel free to note any information that you might find useful (maybe user and password for test accounts, dependencies or other Infos).
After we review this last step and hit the save button, we can see the green marks, and Submit to the Store button is now available on the Submission 1 overview page.
5. Final thoughts
With our final step of pushing the Submit button, what we need to do now is wait. That’s right. We did our part, and now Microsoft has to pre-process and digitally sign our MSIX. Once all this is done, based on our publishing options edited in early steps, our app is released public or private.