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], or run installToolchain.sh.
   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 1. Create a separate build folder. Do not build in this source directory.
  20
  21 2. Run "../tools/configure". Choose the "Android" target and input your
  22    screen resolution.
  23
  24 3. Run "make"
  25
  26 4. Run "make zip". This has to be run the first time, and any time themes
  27    or plugins have changed. Otherwise you may skip it.
  28
  29 5. Run "make apk"
  30
  31 6. Optional. Install on your target/emulator, using the following command:
  32    "$ANDROID_SDK_PATH/tools/adb install -r rockbox.apk"
  33
  34
  35 [1]: http://developer.android.com/sdk/index.html
  36 [2]: http://developer.android.com/sdk/ndk/index.html
  37 [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/
  38 [4]: http://developer.android.com/sdk/installing.html