Signing and Building — Kindle Fire

This guide explains how to sign, build, and test your app on Amazon's Kindle Fire devices.

Notes

Preparing for Kindle Fire

You don't need to do anything different to prepare your app for release on Kindle Fire, but you should note the following device specifications and design your app content accordingly. Specifications listed below are in pixels.

Model Resolution (w×h) Status Bar (top) Soft Keys Bar (bottom)
Kindle Fire 600 × 1024 27 60
Kindle Fire HD 7" 800 × 1280 35 78
Kindle Fire HD 8.9" 1200 × 1920 40 90

Also, note that Amazon prefers apps to occupy the entire screen. If you set the scale to letterbox in config.lua, make sure that you fill the "empty" space with actual content. See here for more information on content and scaling.

Java Package Name

When you build a Kindle Fire app using Solar2D, you must specify a package name. In general, you can specify any package name you like, but it must be chosen carefully because it should be unique to your application.

The traditional Java scheme is to use the reverse-domain format like com.acme, then append the name of a division/product, and finally append the name of the app. For example, com.acme.games.catchafish would be a good package name, assuming you own the acme.com domain name.

In some cases, the package name that results from using reverse-domain format may not be valid, and it must be modified before Solar2D will build your Kindle Fire app. This would be true in any of the following cases:

Build Process

Important

If you aren't familiar with the available build settings for an app, please review them before proceeding with this section.

  1. From the Solar2D Simulator, select FileOpen... to load the project you wish to build.

  2. Select FileBuildAndroid....

  3. Fill in the information:

    • Application Name — by default, this will match your project folder; keep this name or specify another.

    • Version Code — this value must be an integer. Each time you update your app, you must increase the version code. It corresponds to the versionCode item detailed here. It is not visible to users.

    • Version Name — specify a version name for your app.

    • Package — see Java Package Name above.

    • Target App Store — select Amazon from the pull-down list.

    • Keystore / Key Alias — in order to build for Android devices, you must digitally sign your app using a keystore. Please refer to either Signing for Debug Build or Signing for Release Build below.

    • Save to Folder — specify where to save the compiled app.

    • After Build — select which action should be performed after the app is successfully built.

    *Create Live Build — check this box to create a live build for lightning-fast testing. See Generating Live Builds for details.

  4. Click Build and Solar2D will compile the app into a standard .apk file.

Signing for Debug Build

For debug builds, Solar2D includes a debug.keystore for testing your app on devices. To use it, follow these steps:

  1. Select Debug from the Keystore menu.

  2. Directly to the right, Browse... to the keystore file in the Solar2D application folder:

Windows — C:\Program Files (x86)\Corona Labs\Corona\Resources\debug.keystore

macOS — /Applications/Corona/Resources/Resource Library/Android/debug.keystore

  1. Select the file and enter android as the password.

  2. In the Key Alias menu, select androiddebugkey.

Signing for Release Build

For release builds, you must sign with your private key. You can generate this key using the command line program Keytool. Please follow these simple steps:

  1. Open the Command Prompt in Windows or the Terminal in macOS. Once there, use the cd command to change to the directory where you'll keep your keystores.

  2. Type the following command at the prompt, replacing mykeystore with the name of your application and aliasname with a similar or equal alias name.

keytool -genkey -v -keystore mykeystore.keystore -alias aliasname -keyalg RSA -validity 999999

  1. You'll be prompted for your credentials. Supply the requested information and tap enter to sign your Android app.

Installation and Debugging

Once your app is compiled via Solar2D, the next step is to register as an Amazon Developer, configure your Kindle Fire for testing, and test/debug the app on a Kindle Fire device or the Kindle Fire Emulator.

  1. If you haven't already signed up for an Amazon Developer account, please do so first.

  2. Next, you'll need to set up your Kindle Fire tablet for testing. You can use Android Debug Bridge to connect your Kindle Fire tablet to a development computer for testing and debugging. Please refer to Amazon's instructional guide for details.

  3. Finally, you can refer to this guide for details on testing your app.