rockbox/android
Thomas Martitz 4d2ab32339 Android: Work around an android bug.
BitmapFactory.decodeFile() fails when called outside the main thread.
Work around by running the code on the main thread. This also has the advantage
of off-loading from the Rockbox thread which should improve track skipping
delays.

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@30825 a1c6a512-1295-4272-9138-f99709370657
2011-10-22 15:28:09 +00:00
..
res
src/org/rockbox
.classpath
.project
android.make
AndroidManifest.xml
default.properties
installToolchain.sh
README

This folder contains the java parts needed to build an Rockbox as an
application for android.

* Prerequisites

Download and install the Android SDK[1] and NDK[2], or run installToolchain.sh.
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.


Then, make sure you have the ANDROID_SDK_PATH and ANDROID_NDK_PATH (pointing to
the each's root directory) environment variables set up, otherwise configure will fail to find the compiler and
compiling the java files will fail.

* Build instructions

1. Create a separate build folder. Do not build in this source directory.

2. Run "../tools/configure". Choose the "Android" target and input your
   screen resolution.

3. Run "make"

4. Run "make zip". This has to be run the first time, and any time themes
   or plugins have changed. Otherwise you may skip it.

5. Run "make apk"

6. Optional. Install on your target/emulator, using the following command:
   "$ANDROID_SDK_PATH/tools/adb install -r rockbox.apk"


[1]: http://developer.android.com/sdk/index.html 
[2]: http://developer.android.com/sdk/ndk/index.html
[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/
[4]: http://developer.android.com/sdk/installing.html