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