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
- Option A: Retrieve your App's MD5 Signature from Android Studio
- Option B: Get the MD5 and SHA-256 Debug Fingerprint
- Register Your App on the Developer Portal
- Submit Your Debug Registration Request
- Load Your App on a Device for Testing
- Next Step
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:
- Retrieve the MD5 and SHA-256 debug fingerprint for your app.
- Register your app on the developer portal.
- 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
- Open your project in Android Studio
- Click the Gradle tab in the top-right corner
- 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.
|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
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: 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
Register Your App on the Developer Portal
Submit registration requests for your apps on the Developer Portal.
To register your app:
- Sign in, and then open the list of your apps.
- If the app that you want to register for the Amazon Maps API is not already listed, click Add a New App.
- 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:
- On the developer portal, open the list of your apps.
- Click the app that you want to register. (If your app is not listed, first add the app to the portal.)
- Click Maps.
- Click Add a Debug Registration.
- In the Package name box, enter the package name for your app.
- In the Developer signature box, enter the MD5 and SHA-256 fingerprint of the debug certificate that you obtained by running the keytool command.
- 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.