= Building the Lol Engine for Android platforms =

== Android SDK ==

 * Download the [http://developer.android.com/sdk/index.html SDK], unpack it to ''e.g.'' `~/android/` and optionally run the SDK and AVD manager: `./tools/android`
 * Set the following environment variables (make sure the directory names match your versions):
{{{
#!sh
PATH="$PATH:$HOME/android/android-sdk-linux_86/tools"
PATH="$PATH:$HOME/android/android-sdk-linux_86/platform-tools"
export PATH
}}}
 * To run the emulator, run `emulator @foo` where `foo` is the name of the image

== Android NDK ==

 * Download the [http://developer.android.com/sdk/ndk/index.html NDK], unpack it to `~/android/`.
 * Set the following environment variables (make sure the directory names match your versions):
{{{
#!sh
ANDROID_NDK_ROOT="$HOME/android/android-ndk-r9"
ANDROID_NDK_ARM_TOOLCHAIN="$HOME/android/arm-linux-androideabi"
}}}

 * Run the following command:
{{{
#!sh
$ANDROID_NDK_ROOT/build/tools/make-standalone-toolchain.sh \
   --arch=arm --install-dir=$ANDROID_NDK_ARM_TOOLCHAIN \
   --ndk-dir=$ANDROID_NDK_ROOT --platform=android-14
}}}

 * Add `$ANDROID_NDK_ARM_TOOLCHAIN/bin` to `PATH`.

== Autobuilder configuration (build bots only) ==

Add the following section to the bitten machine file:

{{{
#!ini
[ndk]
version = 9
}}}

== Notes ==

 * [http://codemaemo.appforce.org/2010/07/tutorial-using-eclipse-for-ndk-projects/ Using Eclipse for NDK Projects]
 * [http://www.slideshare.net/owenhsu/happy-porting-x86-application-to-android-4734253 Happy porting x86 application to android]
 * [http://androgeek.info/?p=275 Load png from assets in NDK]
 * [http://www.netmite.com/android/mydroid/1.6/development/ndk/docs/ANDROID-MK.TXT Android.mk format]