rockbox/android
Thomas Martitz 7f9e76556d Removed a bit too much, libmisc.so shall still depend on rockbox.zip
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@28142 a1c6a512-1295-4272-9138-f99709370657
2010-09-22 20:58:54 +00:00
..
res Delete now unused icons. 2010-08-04 20:38:25 +00:00
src/org/rockbox Adhere to the 80-char line width limit. 2010-09-12 20:10:05 +00:00
.classpath Rockbox as an application: Commit current Android port progress. 2010-08-02 20:34:47 +00:00
.project Rockbox as an application: Commit current Android port progress. 2010-08-02 20:34:47 +00:00
android.make Removed a bit too much, libmisc.so shall still depend on rockbox.zip 2010-09-22 20:58:54 +00:00
AndroidManifest.xml Android: Fix a problem where entered Rockbox multiple times (with multiple instances on the activity stack) until it was exited once with the back button. 2010-09-12 09:50:45 +00:00
build.sh Android port: also include native libraries in APK file 2010-08-17 21:13:13 +00:00
default.properties Android port: allow moving application to SD card on Froyo targets 2010-08-16 20:47:46 +00:00
README Android port: Remove the "make zip" dependency of make apk again (see r28068). 2010-09-22 20:50:06 +00:00

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].
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

Use this as your build folder, using '../tools/configure' etc.
    $ ../tools/configure # type 200, then chose A for android and your screen resolution
    $ make


After the build finished, build the zip file which contains codecs and themes (the binary is a separate file):
    $ make zip

Once you have the zip, pack it and the binary into the apk
    $ make apk

Side note: You don't necessarily need to recreate the zip once you have it, only if you're unsure or if you know its content changed. 
Not recreating it will save time because it's only unzipped on the device if it's newer than what's on the device

You can install that on your device or emulator with the following command:
    $ $ANDROID_SDK_PATH/tools/adb install -r bin/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