rockbox/android/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
Rockbox as an application: Commit current Android port progress. General state is: Rockbox is usable (plays music, saves configuration, touchscreen works too). Problems: - Playing music in the background (i.e. when switching to another app) doesn't work reliably, but I'm working on that now. - no cabbiev2 (only some preliminary files for it), no other default theme. - screen flickers sometimes if the updates are too frequent - no multi screen apk/package - strange behavior when a phone call comes in The java files (and the eclipse project) resides in android/, which is also supposed to be the build folder. I've put a small README in there for instructions. There are some steps needed after the make part, which are described there, and which eclipse mostly handles. But there ought to be some script/makefile rules which do that instead in the future. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27668 a1c6a512-1295-4272-9138-f99709370657 2010-08-02 20:34:47 +00:00			`This folder contains the java parts needed to build an Rockbox as an`
			`application for android.`

Update README a bit. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27718 a1c6a512-1295-4272-9138-f99709370657 2010-08-05 12:15:30 +00:00			`* Prerequisites`

Android: add a script which allows headless installation of the Android tools required for compilation git-svn-id: svn://svn.rockbox.org/rockbox/trunk@28525 a1c6a512-1295-4272-9138-f99709370657 2010-11-06 17:32:52 +00:00			`Download and install the Android SDK[1] and NDK[2], or run installToolchain.sh.`
Extend android.make so that it can generate a debug signed apk. 'make && make apk && adb install -r bin/Rockbox.apk' should work now. You should now be able to develop without eclipse. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27980 a1c6a512-1295-4272-9138-f99709370657 2010-09-02 03:40:02 +00:00			`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.`
Rockbox as an application: Commit current Android port progress. General state is: Rockbox is usable (plays music, saves configuration, touchscreen works too). Problems: - Playing music in the background (i.e. when switching to another app) doesn't work reliably, but I'm working on that now. - no cabbiev2 (only some preliminary files for it), no other default theme. - screen flickers sometimes if the updates are too frequent - no multi screen apk/package - strange behavior when a phone call comes in The java files (and the eclipse project) resides in android/, which is also supposed to be the build folder. I've put a small README in there for instructions. There are some steps needed after the make part, which are described there, and which eclipse mostly handles. But there ought to be some script/makefile rules which do that instead in the future. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27668 a1c6a512-1295-4272-9138-f99709370657 2010-08-02 20:34:47 +00:00

Extend android.make so that it can generate a debug signed apk. 'make && make apk && adb install -r bin/Rockbox.apk' should work now. You should now be able to develop without eclipse. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27980 a1c6a512-1295-4272-9138-f99709370657 2010-09-02 03:40:02 +00:00			`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.`
Update README a bit. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27718 a1c6a512-1295-4272-9138-f99709370657 2010-08-05 12:15:30 +00:00
			`* Build instructions`

Minor build script tweaks to make android auto-buildable. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@28156 a1c6a512-1295-4272-9138-f99709370657 2010-09-24 12:03:15 +00:00			`1. Create a separate build folder. Do not build in this source directory.`
Rockbox as an application: Commit current Android port progress. General state is: Rockbox is usable (plays music, saves configuration, touchscreen works too). Problems: - Playing music in the background (i.e. when switching to another app) doesn't work reliably, but I'm working on that now. - no cabbiev2 (only some preliminary files for it), no other default theme. - screen flickers sometimes if the updates are too frequent - no multi screen apk/package - strange behavior when a phone call comes in The java files (and the eclipse project) resides in android/, which is also supposed to be the build folder. I've put a small README in there for instructions. There are some steps needed after the make part, which are described there, and which eclipse mostly handles. But there ought to be some script/makefile rules which do that instead in the future. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27668 a1c6a512-1295-4272-9138-f99709370657 2010-08-02 20:34:47 +00:00
Update Android README in line with configure changes from r29286 git-svn-id: svn://svn.rockbox.org/rockbox/trunk@29296 a1c6a512-1295-4272-9138-f99709370657 2011-02-13 13:26:16 +00:00			`2. Run "../tools/configure". Choose the "Android" target and input your`
			`screen resolution.`
Android port: Remove the "make zip" dependency of make apk again (see r28068). It was reintroduced in r28138. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@28141 a1c6a512-1295-4272-9138-f99709370657 2010-09-22 20:50:06 +00:00
Minor build script tweaks to make android auto-buildable. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@28156 a1c6a512-1295-4272-9138-f99709370657 2010-09-24 12:03:15 +00:00			`3. Run "make"`
Android port: Remove the "make zip" dependency of make apk again (see r28068). It was reintroduced in r28138. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@28141 a1c6a512-1295-4272-9138-f99709370657 2010-09-22 20:50:06 +00:00
Minor build script tweaks to make android auto-buildable. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@28156 a1c6a512-1295-4272-9138-f99709370657 2010-09-24 12:03:15 +00:00			`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.`
Update README a bit. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27718 a1c6a512-1295-4272-9138-f99709370657 2010-08-05 12:15:30 +00:00
Minor build script tweaks to make android auto-buildable. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@28156 a1c6a512-1295-4272-9138-f99709370657 2010-09-24 12:03:15 +00:00			`5. Run "make apk"`
Android port: Remove the "make zip" dependency of make apk again (see r28068). It was reintroduced in r28138. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@28141 a1c6a512-1295-4272-9138-f99709370657 2010-09-22 20:50:06 +00:00
Minor build script tweaks to make android auto-buildable. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@28156 a1c6a512-1295-4272-9138-f99709370657 2010-09-24 12:03:15 +00:00			`6. Optional. Install on your target/emulator, using the following command:`
			`"$ANDROID_SDK_PATH/tools/adb install -r rockbox.apk"`
Rockbox as an application: Commit current Android port progress. General state is: Rockbox is usable (plays music, saves configuration, touchscreen works too). Problems: - Playing music in the background (i.e. when switching to another app) doesn't work reliably, but I'm working on that now. - no cabbiev2 (only some preliminary files for it), no other default theme. - screen flickers sometimes if the updates are too frequent - no multi screen apk/package - strange behavior when a phone call comes in The java files (and the eclipse project) resides in android/, which is also supposed to be the build folder. I've put a small README in there for instructions. There are some steps needed after the make part, which are described there, and which eclipse mostly handles. But there ought to be some script/makefile rules which do that instead in the future. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27668 a1c6a512-1295-4272-9138-f99709370657 2010-08-02 20:34:47 +00:00

Update README a bit. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27718 a1c6a512-1295-4272-9138-f99709370657 2010-08-05 12:15:30 +00:00			`[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`