Preparations for the Android package

Before you packaging the Android application, make the following preparations accordingly:

(Required) Obtain a private key

The Android operating system requires that all installed applications be digitally signed with a certificate whose private key is held by the application's developer and uses the certificate as a means of identifying the author of an application and establishing trust relationships between applications. You can either use the default keystore file generated by Appeon or use the Keytool utility included in the Java Development Kits (JDK) to generate your private key. For details, refer to http://developer.android.com/tools/publishing/app-signing.html.

If you choose to use the keystore file provided by Appeon, you can bypass this section and go ahead to create the Android package, the Appeon keystore file will be automatically used by default.

Here is an example of a Keytool command that generates a private key (you can execute the command in any folder if the JAVA_HOME environment variable correctly points to the JDK directory, otherwise, you should first change to the JDK bin directory (using the "cd" command as shown below), and then execute the Keytool command there):

cd C:\Program Files\Java\jdk1.6.0_24\bin
Keytool -genkey -alias myalias -keypass mypass -keyalg RSA -keysize 1024 -validity 3650 -keystore C:\my.keystore -storepass mypass

The Keytool command prompts you to provide the owner information.

Figure 131. Generate keystore

Generate keystore

After the keystore file is generated, remember the file name and location (C:\my.keystore in the above example) and the password, as you will need to include the keystore file when packaging the application later. To include the file, specify the relevant information in the App Signing section in the Appeon Application Package Wizard.

(Optional) Obtain a Google Maps API key

If you plan to provide the Google Maps functionality in the application, you would need to register for a Google Maps API key first and then include the key when packaging the application in the Appeon Application Package Wizard. The key is free and you can use it with any of your applications that call the Map APIs (for how to call Map APIs, see the section called “Map” in Workarounds & APIs Guide), and it supports an unlimited number of users.

Below are instructions for generating the Google Map API key in the Google Developers Console.

  1. Obtain the SHA1 fingerprint of the keystore file that will be used to sign the application.

    The keystore file should have already been generated, if not, follow instructions in the previous section Obtain a private key to generate a keystore file. Make sure you have installed JDK so the Keytool utility included in it is available to use.

    Here is an example of a Keytool command that retrieves the SHA1 fingerprint of the keystore file (you can execute the command in any folder if the JAVA_HOME environment variable correctly points to the JDK directory, otherwise, you should first change to the JDK bin directory (using the "cd" command as shown below), and then execute the Keytool command there):

    cd C:\Program Files\Java\jdk1.6.0_24\bin
    keytool -list -v -keystore C:\my.keystore

    Figure 132. SHA1 fingerprint

    SHA1 fingerprint

  2. Turn on the Google Maps APIs.

    You should register for a Google developer account first if you do not have one, as you will need to log into the Google Developers Console (https://code.google.com/apis/console) to turn on the Google Maps API and create the key.

    1. Log into the Google Developers Console.

    2. Click Create Project to create a new project for Google Maps API, or use an existing project.

    3. Click APIs under APIs & AUTH on the left navigation pane, and then click the switch indicator on the right to turn on Google Maps Android API v2 and Google Maps Coordinate API on the right side.

      Figure 133. Create the key

      Create the key

  3. Create the API key that binds with the specified application(s).

    1. In the Google Developers Console, click Credentials under APIs & AUTH on the left navigation pane, and then click Create new key under Public API access on the right.

      Figure 134. SHA1 fingerprint

      SHA1 fingerprint

    2. In the popup Create a new key dialog, click Android key.

      Figure 135. Create Android key

      Create Android key

    3. Input the SHA1 fingerprint and the application name (separated by a semicolon) per line in the text box, and then click Create.

      Notes:

      • The same application name must be specified as the App Identifier in the Appeon Application Package Wizard later.

      • The generated API key should be included in the application. To do this, specify the key in the Map API Key field in Appeon Application Package Wizard later.

      Figure 136. Create the key

      Create the key

(Optional) Prepare the icons/images for your application

You can provide you own app icons and splash/launch images for your Android application. If you do not provide the icons and images, the Package Wizard will use the default ones provided by Appeon.

Android powers a variety of devices with different screen sizes and densities, in order to get a proper UI look on those different screens, you may need to provide different app icons and splash/launch images for your app.

  1. App Icons: Refer to App Icon for the size requirement for different Android screens.

  2. Splash/Launch Images: Refer to Splash Image for the size requirement for different Android screens.