summaryrefslogtreecommitdiffstats
path: root/android/README
blob: 6c9d2ad4c64deab5139198338851725f6fe457e3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
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 which contains codecs and themes (the binary is a separate file):
    $ make zip

Once you have the zip, pack it and the binary into the apk
    $ make apk

Side note: You don't necessarily need to recreate the zip once you have it, only if you're unsure or if you know its content changed. 
Not recreating it will save time because it's only unzipped on the device if it's newer than what's on the device

You can install that on your device or emulator with the following command:
    $ $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