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]. After you extracted the SDK, you need to run <sdk-dir>/tools/android in order to install the actual platform sdk from the available packages tab (SDK Platform Android 1.5 or above should work). In the virtual devices tab you can also setup a emulator.
   7
   8
   9 Then, make sure you have the ANDROID_NDK_PATH (pointing to the NDK's root directory) environment variable set up,
  10 otherwise configure will fail to find the compiler.
  11
  12
  13 * Build instructions
  14
  15 Until there's a script which does all the work the procedure is documented here.
  16
  17 Use this as your build folder, using '../tools/configure' etc.
  18     $ ../tools/configure
  19     $ make
  20
  21 After the build finished, you need to copy librockbox.so to libs/armeabi/ (create that dir if it doesn't exit)
  22     $ mkdir -p libs/armeabi
  23     $ cp librockbox.so libs/armeabi
  24
  25 For the other files (codecs, themes), you execute 'make zip'. Then you copy the
  26 zip to libs/armeabi, using the name libmisc.so. This is needed, since there's no
  27 way to bundle stuff into apk's and have access to them from native code other
  28 than pretending it was a library.
  29     $ make zip
  30     $ cp rockbox.zip libs/armeabi/libmisc.so
  31
  32 rockbox.zip..err, libmisc.so will be unpacked at runtime.
  33
  34 To finish, you can follow this guide [3], or use eclipse. Simply install eclipse
  35 and the android plugins, then import this folder as a new Android project and run it.
  36 See [4] for a guide on how to set up eclipse for android development.
  37
  38
  39
  40 [1]: http://developer.android.com/sdk/index.html
  41 [2]: http://developer.android.com/sdk/ndk/index.html
  42 [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/
  43 [4]: http://developer.android.com/sdk/installing.html