# HG changeset patch # User Sam Lantinga # Date 1294442297 28800 # Node ID f74a3f94c408addf9349bd68c896afa0eb707194 # Parent a130bc2f0a18220881b8e39245a6c0192beb0b6c Added some more information on how the port works diff -r a130bc2f0a18 -r f74a3f94c408 README.android --- a/README.android Fri Jan 07 09:53:08 2011 -0800 +++ b/README.android Fri Jan 07 15:18:17 2011 -0800 @@ -10,6 +10,7 @@ Android NDK r4 or later http://developer.android.com/sdk/ndk/index.html + ================================================================================ How the port works ================================================================================ @@ -21,6 +22,16 @@ Java project, along with some C support code that communicates with Java - This eventually produces a standard Android .apk package +The Android Java code implements an "activity" and can be found in: +android-project/src/org/libsdl/app/SDLActivity.java + +The Java code loads your game code, the SDL shared library, and +dispatches to native functions implemented in the SDL library: +src/SDL_android.cpp + +Your project must include some glue code that starts your main() routine: +src/main/android/SDL_android_main.cpp + ================================================================================ Building an app @@ -48,11 +59,11 @@ build.xml - build description file, used by ant default.properties - holds the ABI for the application, currently android-4 which corresponds to the Android 1.6 system image local.properties - holds the SDK path, you should change this to the path to your SDK - jni/ - directory holding native code and Android.mk + jni/ - directory holding native code jni/Android.mk - Android makefile that includes all subdirectories jni/SDL/ - directory holding the SDL library files jni/SDL/Android.mk - Android makefile for creating the SDL shared library - jni/src/ - directory holding your application source + jni/src/ - directory holding your C/C++ source jni/src/Android.mk - Android makefile that you should customize to include your source code and any library references res/ - directory holding resources for your application res/drawable-* - directories holding icons for different phone hardware