1 ================================================================================
2 Simple DirectMedia Layer for Android
3 ================================================================================
5 Requirements: Android NDK r4 or later
7 ================================================================================
9 ================================================================================
11 - Android applications are Java-based, optionally with parts written in C
12 - As SDL apps are C-based, we use a small Java shim that uses JNI to talk to
14 - This means that your application C code must be placed inside an android
15 Java project, along with some C support code that communicates with Java
16 - This eventually produces a standard Android .apk package
23 ================================================================================
25 ================================================================================
28 1. Edit android/config.cfg to point to the location of the NDK
29 2. Run 'make -f Makefile.android'. If all goes well, libsdl.a should be created
30 3. Place your application source files in android/project/jni
31 4. Edit the Android.mk to include your source files
32 5. Run 'ndk-build' (a script provided by the NDK). This compiles the C source
33 6. Run 'ant' in android/testproject. This compiles the .java and eventually
34 creates a .apk with the C source embedded
35 7. 'ant install' will push the apk to the device or emulator (if connected)
40 ================================================================================
42 ================================================================================
44 - SDL audio (although it's mostly written, just not working properly yet)
45 - TODO. I'm sure there's a bunch more stuff I haven't thought of