This repository has been archived by the owner on Feb 11, 2021. It is now read-only.
README.android
1
================================================================================
2
Simple DirectMedia Layer for Android
3
================================================================================
5
6
Requirements: Android SDK and Android NDK r4 or later
http://developer.android.com/
8
9
10
11
12
13
14
15
16
17
18
19
================================================================================
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
20
21
22
================================================================================
Building an app
================================================================================
24
25
26
27
28
29
Instructions:
1. Copy the android-project directory wherever you want your Android project to go
2. Move this SDL directory into the <project>/jni directory
3. Place your application source files in the <project>/jni/src directory
4. Edit <project>/jni/src/Android.mk to include your source files
5. Run 'ndk-build' (a script provided by the NDK). This compiles the C source
31
32
33
34
35
36
If you want to use the Eclipse IDE, skip to the Eclipse section below.
6. Edit <project>/local.properties to point to the Android SDK directory
7. Run 'ant debug' in android/project. This compiles the .java and eventually
creates a .apk with the native code embedded
8. 'ant install' will push the apk to the device or emulator (if connected)
37
38
39
================================================================================
41
42
================================================================================
46
47
48
49
50
51
52
53
54
55
56
57
================================================================================
Loading files
================================================================================
NEED CONTENT
================================================================================
Troubleshooting
================================================================================
NEED CONTENT
60
61
62
================================================================================
Known issues
================================================================================
64
65
- 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