rockbox

History

Björn Stenberg 23dee22ec7 Added some missing build information. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@28129 a1c6a512-1295-4272-9138-f99709370657		2010-09-20 22:03:48 +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	The zip target isn't a good prerequisite for another make target so remove it.	2010-09-12 20:50:30 +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	Added some missing build information.	2010-09-20 22:03:48 +00:00

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].
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:
    $ make zip

Create a debug signing key:
    $ keytool -genkey -alias androiddebugkey -keystore $HOME/.android/debug.keystore -storepass android -keypass android -validity 365 -dname "CN=Android Debug,O=Android,C=US"

Then, you can create a Rockbox.apk which ends up in bin/
    $ make apk

You can install that on the device:
    $ $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