This repository has been archived by the owner on Feb 11, 2021. It is now read-only.
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
35 additions
and
6 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,16 +1,45 @@ | ||
============================================================================== | ||
================================================================================ | ||
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/testproject/jni | ||
4. Run 'ndk-build' (a script provided by the NDK). This compiles the C source | ||
4. Run 'ant' in android/testproject. This compiles the .java and eventually | ||
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 | ||
6. 'ant install' will push the apk to the device or emulator (if connected) | ||
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 |