rockbox

History

Thomas Martitz ef38221602 android: Hopefully fix a rare hang of the UI. Sometimes (and perhaps only on some devices) Android's YesNo dialog loses focus and is put to the background. Since the native code waits on the result (which is then impossible to happen) it would become impossible to further control Rockbox. This is an attempt to fix as I cannot reproduce the problem on my device(s). Change-Id: Iff849ff4be5e8f41922fb7d36491d860486c6441		2013-01-18 09:49:46 +01:00
..
.externalToolBuilders	android: Add preliminary eclipse support for building the native code, disabled by default.	2012-01-03 23:44:51 +00:00
res	Android: show Album Art in notification area.	2011-10-01 20:07:57 +00:00
src/org/rockbox	android: Hopefully fix a rare hang of the UI.	2013-01-18 09:49:46 +01:00
.classpath	wpsbuild.pl: Fix FS#12706 - paths for backdrops and icons were not properly constructed.	2012-06-25 08:54:21 +02:00
.project	android: Add preliminary eclipse support for building the native code, disabled by default.	2012-01-03 23:44:51 +00:00
android.make	android: Update to SDK r16 and ndk r8d.	2013-01-09 10:33:08 +01:00
AndroidManifest.xml	Android: Undo r30293 partly as it prevents installation.	2011-08-14 13:23:46 +00:00
ant.properties	android: Update build system for recent SDK versions and target ice cream sandwich.	2012-01-03 21:15:21 +00:00
build.xml	android: Update build system for recent SDK versions and target ice cream sandwich.	2012-01-03 21:15:21 +00:00
installToolchain.sh	Fix toolchain installation.	2011-09-08 17:37:01 +00:00
proguard.cfg	android: Update build system for recent SDK versions and target ice cream sandwich.	2012-01-03 21:15:21 +00:00
project.properties	android: Update to SDK r16 and ndk r8d.	2013-01-09 10:33:08 +01: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