summaryrefslogtreecommitdiffstats
path: root/android/README
diff options
context:
space:
mode:
authorThomas Martitz <kugel@rockbox.org>2010-08-05 12:15:30 +0000
committerThomas Martitz <kugel@rockbox.org>2010-08-05 12:15:30 +0000
commite8542efdb102d516f02620386e496af5be74d8b1 (patch)
tree19241c9f5f7e92326ee589e1c8825ca13a97c7f8 /android/README
parent3f8e7fc26fdecde65fb78de84e4df31df8c0e750 (diff)
downloadrockbox-e8542efdb102d516f02620386e496af5be74d8b1.tar.gz
rockbox-e8542efdb102d516f02620386e496af5be74d8b1.zip
Update README a bit.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27718 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'android/README')
-rw-r--r--android/README29
1 files changed, 19 insertions, 10 deletions
diff --git a/android/README b/android/README
index e41bfa6c0c..c22ab604d1 100644
--- a/android/README
+++ b/android/README
@@ -1,18 +1,25 @@
This folder contains the java parts needed to build an Rockbox as an
application for android.
-* Build instructions
+* 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.
-Until there's a script which does all the work the procedure is documented here.
-First, make sure you have the ANDROID_NDK_PATH environment variable set up,
+Then, make sure you have the ANDROID_NDK_PATH (pointing to the NDK's root directory) environment variable set up,
otherwise configure will fail to find the compiler.
+
+* Build instructions
+
+Until there's a script which does all the work the procedure is documented here.
+
Use this as your build folder, using '../tools/configure' etc.
$ ../tools/configure
$ make
-After the build finished, you need to copy librockbox.so to libs/armeabi/.
+After the build finished, you need to copy librockbox.so to libs/armeabi/ (create that dir if it doesn't exit)
+ $ mkdir -p libs/armeabi
$ cp librockbox.so libs/armeabi
For the other files (codecs, themes), you execute 'make zip'. Then you copy the
@@ -20,15 +27,17 @@ zip to libs/armeabi, using the name libmisc.so. This is needed, since there's no
way to bundle stuff into apk's and have access to them from native code other
than pretending it was a library.
$ make zip
- $ cp rockbox.zip lib/armeabi/libmisc.so
+ $ cp rockbox.zip libs/armeabi/libmisc.so
rockbox.zip..err, libmisc.so will be unpacked at runtime.
-To finish, you can follow this guide [1], or use eclipse. Simply install eclipse
+To finish, you can follow this guide [3], or use eclipse. Simply install eclipse
and the android plugins, then import this folder as a new Android project and run it.
-See [2] for a guide on how to set up eclipse for android development.
+See [4] for a guide on how to set up eclipse for android development.
+
-
-[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/
-[2]: http://developer.android.com/sdk/installing.html
+[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