android/README

   1 This folder contains the java parts needed to build an Rockbox as an
   2 application for android.
   3
   4 * Prerequisites
   5
   6 Download and install the Android SDK[1] and NDK[2].
   7 After you extracted the SDK, you need to run <sdk-dir>/tools/android in order to
   8 install the actual platform sdk from the available packages tab (SDK Platform
   9 Android 1.5 or above should work).
  10 In the virtual devices tab you can also setup a emulator.
  11
  12
  13 Then, make sure you have the ANDROID_SDK_PATH and ANDROID_NDK_PATH (pointing to
  14 the each's root directory) environment variables set up, otherwise configure will fail to find the compiler and
  15 compiling the java files will fail.
  16
  17 * Build instructions
  18
  19 Use this as your build folder, using '../tools/configure' etc.
  20     $ ../tools/configure # type 200, then chose A for android and your screen resolution
  21     $ make
  22
  23 After the build finished, you can create a Rockbox.apk in bin/
  24     $ make apk
  25
  26 You can install that on the device
  27     $ $ANDROID_SDK_PATH/tools/adb install -r bin/Rockbox.apk
  28
  29
  30 NOTE: make apk needs creates a debug signed .apk, not suitable for distribution.
  31 It expects that this key already exists.
  32 You should be able to generate it with "keytool" using the following options:
  33 * Keystore name: "debug.keystore"
  34 * Keystore password: "android"
  35 * Key alias: "androiddebugkey"
  36 * Key password: "android"
  37 * CN: "CN=Android Debug,O=Android,C=US"
  38 * validity: 365 days
  39
  40 Google docs mention the SDK tools can generate it as well, but I haven't found how yet.
  41
  42 [1]: http://developer.android.com/sdk/index.html
  43 [2]: http://developer.android.com/sdk/ndk/index.html
  44 [3]: http://asantoso.wordpress.com/2009/09/15/how-to-build-android-application-package-apk-from-the-command-line-using-the-sdk-tools-continuously-integrated-using-cruisecontrol/
  45 [4]: http://developer.android.com/sdk/installing.html