Convert your existing Chrome app to a UWP app
We have made it easy to convert your existing Chrome hosted app to an app running on the Universal Windows Platform (UWP). There are two ways to convert your Chrome app:
Option #1: ManifoldJS now accepts Chrome manifests as a form of input.
Option #2: We have developed a CLI tool that generates an
.appxpackage from your existing
Convert your existing Chrome app using the Command-Line Interface
Open a command prompt window to the directory of your choice
Install Hosted Web Apps (HWA) Command Line Interface (CLI) by entering the following in your command line:
npm i -g hwa-cli
Convert your Chrome package (
.zipare the supported package formats), by entering the following in your command line:
hwa convert path/to/chrome/app.crxor
hwa convert path/to/chrome/app.zip
path/to/chrome/appwith the path information leading to your chrome app.
.appxwill appear in the same folder as your Chrome package. You are now ready to upload your app to the Microsoft Store.
Uploading your app to the Microsoft Store
AppX package by navigating to the "Packages" page in the Submissions section.
Fill out the Microsoft Store prompts.
During the conversion process, you will be prompted for an Identity Name, Publisher Identity, and Publisher Display Name. To retrieve these values, visit the Dashboard in the [Windows Dev Center](https://developer.microsoft.com/windows). - Click on "[Create a new app](https://developer.microsoft.com/dashboard/Application/New)" and reserve your app name.
- Next, click on "App identity" in the menu on the left under the "App management" section.
- You should see the three values for which you are prompted listed on the page:
1. Identity Name:
2. Publisher Identity:
3. Publisher Display Name:
Guide for migrating your Hosted Web App
After packaging your web app for the Microsoft Store, customize it so that it works great across all Windows-based devices, including PCs, tablets, phones, HoloLens, Surface Hub, Xbox and Raspberry Pi.
Application Content URI Rules
Application Content URI Rules (ACURs) or Content URIs define the scope of your Hosted Web App through a URL allow list in your app package manifest. In order to control the communication to and from remote content, you must define which URLs are included in, and/or excluded from, this list. If a user clicks a URL that is not explicitly included, Windows will open the target path in the default browser. With ACURs, you are also able to grant a URL access to Universal Windows APIs.
At the very minimum, your rules should include your app’s start page. The conversion tool will automatically create a set of ACURs for you, based on your start page and its domain. However, if there are any programmatic redirects, whether on the server or on the client, those destinations will need to be added to the allow list.
Many apps use third-party sites for their login flows, e.g. Facebook and Google. The conversion tool will automatically create a set of ACURs for you, based on the most popular sites. If your method of authentication is not included in that list, and it’s a redirect flow, you will need to add its path(s) as an ACUR. You can also consider using a web authentication broker.
Flash is not allowed in Windows 10 apps. You will need to make sure your app experience is not affected by its absence.
YouTube videos should still work, as they now default to HTML5
<video>, so long as you are using the
<iframe> embed method. If your app still uses the Flash API, you will need to switch to the aforementioned style of embed.
The Chrome web store already requires a 128x128 app icon image in your app package. For Windows 10 apps, you must supply 44x44, 50x50, 150x150, and 600x350 app icon images, at the very minimum. The conversion tool will automatically create these images for you, based on the 128x128 image. For a richer, more polished app experience, we highly recommend creating your own image files. Here are some guidelines for tile and icon assets.
App capabilities must be declared in your package manifest in order to access certain APIs and resources. The conversion tool will automatically enable three popular device capabilities for you: location, microphone, and webcam. With the former, the system will still prompt the user for permission before granting access.
Note: Users are notified of all the capabilities that an app declares. We would recommend removing any capabilities that your app does not need.
Traditional file downloads, like you see in the browser, are not currently supported.