Translations

Know another language? Translate this tutorial!

Stats

2,239 visitors
15.4K page views
566 translation visitors
2,052 translation page views

How to export to the Amazon Appstore

Favourite 46 favourites
Tutorial written by AshleyOriginally published on 15th, July 2013 - 5 revisions

Amazon devices, like the Kindle Fire HD, are an Android-based platform but have their own separate app store. It also now supports publishing "web apps" powered by the Chromium browser engine - a great way to publish a HTML5 game as a native-looking app with good performance and features.

Before you begin

You should make sure your game supports multiple screen sizes to cover all existing and future devices which could have different sized screens. It should also of course support touch controls.

You will need to host your game on a server - like a Chrome or Firefox OS "hosted" app. However thanks to Construct 2's offline support the games should continue to work just fine even when offline, and the offline cache will also save you lots of server bandwidth. Then you can also update your game simply by uploading again to the server. Note it is not recommended to use a free file host like Dropbox or Google Drive, since the bandwidth limits of these services could make your app inaccessible if it becomes popular. There are lots of cheap file hosts around - even paying a small amount will get you a considerably more reliable server.

First-time setup

You'll need to set up an Amazon developer account. Head to developer.amazon.com, register an account, then sign in. You may be asked to fill in some information about your tax identity; be sure to fill it in correctly, especially if you plan to use monetisation features.

Adding a new app

Before you export from Construct 2, you need to know your submission's verification key. Follow these steps to find it out.

In the Home section of the Amazon Developer website, hover over Add a New App. A dropdown list should appear, allowing you to choose either a new Android app or a new Web app. Choose the Add a new Web app option, since Construct 2 games are all made using web-based HTML5 technology.

Adding a web app
Enter the required app title, a category, and some support information. Press Save and the rest of the tabs along the top should enable. Fill them all out as appropriate for your game.

Open the App File(s) tab. You'll find your app has been given a verification key. This is used to ensure you really are the publisher of the game you are trying to submit. Take a note of this. Note you do not need the part which says "verification_key", nor any of the double quotes or commas: just copy the section which is in the format: 00000000-0000-0000-0000-000000000000

Amazon verification key


Testing

You can test your app with the Amazon Web App Tester. Install the app to your device and you can test any URL using the full performance and features of the Chromium-powered browser engine that runs Amazon Web Apps. You can enter a preview over Wifi address in the Web App Tester to test quickly before exporting. After uploading your game you can also enter the web URL and test it from there as well. You can save some URLs for quick testing later.

Note that to test with the full performance and features, use the Amazon Web View button. The Android Web View is very slow in comparison, using the system web view which is not suitable for games at this time.

Exporting from Construct 2

In Construct 2, choose Export project and select Amazon Appstore. After the usual export options, you'll be prompted to enter the Verification key which you found earlier. The Launch path should also be the name of the main page, which by default is index.html. Change this if you rename your main page.

You'll also need to enable in-app purchases or geolocation if your game uses either of them. Note if you enable them, your host must be a secure server, running over the https protocol. This can be a little trickier to set up than an ordinary file host. Contact your hosting provider for help on how to set this up if you need it; you may need to look specifically for a host that supports secure servers.

Once exported, your export folder should have all your game's files. It is effectively an ordinary HTML5 website export, but with an additional file called web-app-manifest.json, which contains information for the Amazon Appstore.

Publishing

Upload all the exported files, including web-app-manifest.json, to your server. (If you don't know how to do this, contact your host.)

Try to visit the web-app-manifest.json file on your server directly, to check it is served correctly. E.g. visit the URL http://www.mysite.com/mygame/web-app-manifest.json in a desktop browser. If an error appears, check your server MIME types are set up to allow .json files to be served. They should be sent with the MIME type: application/json. Once you've got it working, you should be able to see its contents in the browser, which is a small amount of text including your verification key.

Go back to the Amazon Developers site, on your submission's App File(s) tab. Enter the URL to the manifest file again for the Manifest field (e.g. http://www.mysite.com/mygame/web-app-manifest.json). Click Verify and hopefully it will tell you everything is OK.

Fill out the rest of the tabs, and then you should be able to press Submit app!

Unlock your full gamedev potential

Upgrade to the Personal Edition of Construct 2, it has way more features and won't holding back from making money and using your full creativity like the free edition does. It's a one off payment and all Construct 2 editor updates are free for life!

View deals

Plus, it's got a lot of additional features that will help you save time and make more impressive games!

Congratulations on finishing this tutorial!

Did you learn a lot from it? Share it now with your friends!

Share and Copy this Tutorial

You are free to copy, distribute, transmit and adapt this work with correct attribution. Click for more info.

Comments

2
InvaderX 6,322 rep

Awesome! This is very cool.

Wednesday, August 07, 2013 at 6:43:23 PM
2
kenli 7,833 rep

Looking for this awesome opportunity from Amazon! :)

Thursday, August 08, 2013 at 6:27:26 AM
2
Cipriux 19.0k rep

It seems that you cannot sell Web app, only Android app. The pricing tab is missing for web app .

Tuesday, September 03, 2013 at 10:37:14 AM
1
iceangel 32.8k rep

A good option to publish.
Tanks you.

Tuesday, October 29, 2013 at 6:28:27 PM
1
smsanthosh 2,455 rep

great... Thank you very much for sharing....

Tuesday, February 04, 2014 at 6:06:16 PM
1
Bl4ckSh33p 9,601 rep

When I create a new app at amazon there is no verification key in the App Files-Tab. :/

Friday, April 25, 2014 at 11:30:35 AM
0
gadoproductions 506 rep

ok but i do not see where i am supposed to add the manifest. it only asked for a binary (which also i need to know what exactly am i uploading there).

Sunday, March 27, 2016 at 11:19:05 PM

Leave a comment

Everyone is welcome to leave their thoughts! Register a new account or login.