rockbox/android
Frank Gevaerts be9c227270 Don't require a specific BUILD_TOOLS_VERSION.
Pick anything with the correct major version, which should be good enough.

Currently we want sdk version 19, which has tools that come as 19.0.3 or
19.1.0, depending on when exactly the sdk was installed. Both work fine
for rockbox, so accepting both is useful.

Change-Id: Ie31306210e3cfe78288269574e78976b682eab31
2014-09-25 00:26:25 +02:00
..
.externalToolBuilders android: Add preliminary eclipse support for building the native code, disabled by default. 2012-01-03 23:44:51 +00:00
res Fix android SDK version and the yes/no screen title 2014-05-15 20:18:48 +10:00
src/org/rockbox Fix android black screen crash 2014-05-21 18:39:56 +10:00
.classpath android: Get the port up and running again 2014-03-09 18:11:35 +01: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 Don't require a specific BUILD_TOOLS_VERSION. 2014-09-25 00:26:25 +02: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
buildapk.sh android: Get the port up and running again 2014-03-09 18:11:35 +01:00
installToolchain.sh android: Fix installToolchain.sh script. 2014-03-10 12:50:59 +01: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: Get the port up and running again 2014-03-09 18:11:35 +01:00
README Update Android README in line with configure changes from r29286 2011-02-13 13:26:16 +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], 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