Merge branch 'gsoc-android-2' of git+ssh://repo.or.cz/srv/git/kugel-rb into gsoc...
[kugel-rb.git] / android / README
blobe41bfa6c0cfbb9e4c793e4f99f5ddd9121eec935
1 This folder contains the java parts needed to build an Rockbox as an
2 application for android.
4 * Build instructions
6 Until there's a script which does all the work the procedure is documented here.
8 First, make sure you have the ANDROID_NDK_PATH environment variable set up,
9 otherwise configure will fail to find the compiler.
11 Use this as your build folder, using '../tools/configure' etc.
12     $ ../tools/configure
13     $ make
15 After the build finished, you need to copy librockbox.so to libs/armeabi/.
16     $ cp librockbox.so libs/armeabi
18 For the other files (codecs, themes), you execute 'make zip'. Then you copy the
19 zip to libs/armeabi, using the name libmisc.so. This is needed, since there's no 
20 way to bundle stuff into apk's and have access to them from native code other
21 than pretending it was a library.
22     $ make zip
23     $ cp rockbox.zip lib/armeabi/libmisc.so
25 rockbox.zip..err, libmisc.so will be unpacked at runtime.
27 To finish, you can follow this guide [1], or use eclipse. Simply install eclipse
28 and the android plugins, then import this folder as a new Android project and run it.
29 See [2] for a guide on how to set up eclipse for android development.
32     
33 [1]: 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/
34 [2]: http://developer.android.com/sdk/installing.html