rockbox

History

Dominik Riebeling 6c22be4a3d Android: implement headphone detection thus enabling pause on unplug (FS#12097). Listen to headphone plug events. There are currently two glitches with this: - Android takes a while until it reports the unplug event, so there will be some delay until playback gets paused. This is an Android limitation. - Rockbox debounces headphone state changes for one second. Therefore playback will shortly be routed to the speaker on unplug until Rockbox does the actual pause. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@29956 a1c6a512-1295-4272-9138-f99709370657		2011-06-04 19:17:47 +00:00
..
res	Android port: generate initial config when none is present with dynamically	2011-03-11 15:45:22 +00:00
src/org/rockbox	Android: implement headphone detection thus enabling pause on unplug (FS#12097).	2011-06-04 19:17:47 +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	Android: adjust screen orientation based on LCD size.	2011-06-04 10:36:34 +00:00
AndroidManifest.xml	Ask for track information to be resent after creating a new widget.	2011-03-09 18:46:55 +00:00
default.properties	Android: update project to SDKv11	2011-03-11 15:45:34 +00:00
installToolchain.sh	update the toolchains install script to grab the latest and greatest	2011-01-30 02:33:47 +00:00
README	Update Android README in line with configure changes from r29286	2011-02-13 13:26:16 +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], 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