rockbox/android
Thomas Martitz 994aba194b Android: Allow "out-of-tree" builds (outside of android/, e.g. build-android/).
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27988 a1c6a512-1295-4272-9138-f99709370657
2010-09-02 14:58:36 +00:00
..
gen/org/rockbox Fix launcher icon (once more). 2010-08-06 00:53:02 +00:00
res Delete now unused icons. 2010-08-04 20:38:25 +00:00
src/org/rockbox Android: don't compile powermgmt-sim.c 2010-09-01 23:36:15 +00:00
.classpath
.project
android.make Android: Allow "out-of-tree" builds (outside of android/, e.g. build-android/). 2010-09-02 14:58:36 +00:00
AndroidManifest.xml Android port: allow moving application to SD card on Froyo targets 2010-08-16 20:47:46 +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 Extend android.make so that it can generate a debug signed apk. 2010-09-02 03:40:02 +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, you can create a Rockbox.apk in bin/
    $ make apk

You can install that on the device
    $ $ANDROID_SDK_PATH/tools/adb install -r bin/Rockbox.apk


NOTE: make apk needs creates a debug signed .apk, not suitable for distribution.
It expects that this key already exists.
You should be able to generate it with "keytool" using the following options:
* Keystore name: "debug.keystore"
* Keystore password: "android"
* Key alias: "androiddebugkey"
* Key password: "android"
* CN: "CN=Android Debug,O=Android,C=US"
* validity: 365 days

Google docs mention the SDK tools can generate it as well, but I haven't found how yet.    

[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