Developer Console
Vielen Dank für deinen Besuch. Diese Seite ist nur in Englisch verfügbar.

Register and Test Your Maps App (v2.5)

To access the Amazon Maps API map tiles, you must register your app. Once you do that, you can test it on a Fire tablet.

Register Your App

Every app must have its own registration. Debug and release builds require separate registration. To load map tiles during testing, you must register the debug build of your app. Registration for the release build is a separate process and occurs automatically when you submit your app, if you have already created a debug registration.

Registration for apps that use Maps v1, migrates to v2.

Registration requires three steps:

  1. Retrieve the MD5 and SHA-256 debug fingerprint for your app.
  2. Register your app on the developer portal.
  3. Submit a debug registration request for your app. Provide the debug fingerprint retrieved in step 1 in this submission.

With your registration request, you must provide the MD5 and SHA-256 debug fingerprint.

Option A: Retrieve your App's MD5 Signature from Android Studio

  1. Open your project in Android Studio
  2. Click the Gradle tab in the top-right corner
  3. Expand your app's entry, then expand Tasks, then android, and double click on signingReport

After a few seconds the IDE generates a report in the status area at the bottom, where you will see MD5, SHA1, and SHA-256 info. Copy and store this info for future reference.

Option B: Get the MD5 and SHA-256 Debug Fingerprint

The tools that you use to build your app will generate that. To obtain the fingerprint, run a keytool command from the JDK bin directory.

Step 1: Get the Debug Fingerprint

To directly get the debug fingerprint from the APK file using Option B, without knowing your keystore location, use this command:

keytool -list -printcert -jarfile <your APK path here>

Alternatively to the above, if you would like to find the debug keystore location first, follow the instructions below. (If you used the previous approach directly move to Step 2).

This table shows the default locations for the debug keystore.

Operating system Path
Windows 10 <SYSTEMDRIVE> \Users\ <user>\ .android\debug.keystore
Mac OS / Linux ~/.android/debug.keystore

At the command line, run the following command:

Mac OS/ Linux:

    keytool -v -list -alias androiddebugkey -keystore ~/.android/debug.keystore -storepass android

Windows:

    keytool -v -list -alias androiddebugkey -keystore %HOMEPATH%\.android\debug.keystore  -storepass android

Step 2: Confirm Successful Output

When the command runs successfully, it produces output similar to the following:

Alias name: androiddebugkey
Creation date: Aug 11, 2014
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 00000000
Valid from: Mon Aug 11 15:16:52 PDT 2014 until: Wed Aug 03 15:16:52 PDT 2044
Certificate fingerprints:
    MD5:  00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00
    SHA1: 00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00
    SHA256: 00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00
Signature algorithm name: SHA256withRSA

If you see only the SHA1 fingerprint under Certificate fingerprints, use the -v option of Step 1 and then run the command again.

If you omit the -storepass parameter, you are prompted to enter the password for the keystore. The default password for the debug keystore is android.

Register Your App on the Developer Portal

Submit registration requests for your apps on the Developer Portal.

To register your app:

  1. Sign in, and then open the list of your apps.
  2. If the app that you want to register for the Amazon Maps API is not already listed, click Add a New App.
  3. Fill out the form, and then click Save.

Submit Your Debug Registration Request

To submit a debug registration request for apps that use the Amazon Maps API:

  1. On the developer portal, open the list of your apps.
  2. Click the app that you want to register. (If your app is not listed, first add the app to the portal.)
  3. Click Maps.
  4. Click Add a Debug Registration.
  5. In the Package name box, enter the package name for your app.
  6. In the Developer signature box, enter the MD5 and SHA-256 fingerprint of the debug certificate that you obtained by running the keytool command.
  7. Click Submit.

It takes time to propagate the registration to your device. After clicking Submit, allow one hour before testing the app that you registered. If a recently registered app does not show map tiles, you might need to allow more time for registration to take effect.

Load Your App on a Device for Testing

Once you have registered your app, connect your device to a development computer for testing and debugging, and build your app.

For information about using ADB, see Connect to Fire Tablet through ADB.

Next Step

See Using the Amazon Maps Sample App (v2.5).