Building AndroWish

Requirements

• Android SDK (version 12 or later)
• Android NDK (r7 or later)
• Minimum API level support by SDL is 10 (Android 2.3.3), requested API level from project.properties is 16 (Android 4.1)
• CPUs supported for native shared libraries are currently armeabi and x86. This can be changed in jni/Application.mk.

Building and Running AndroWish

Old school using Apache ant:

1. Refresh the project settings using the android command from Android SDK: android update project
2. Review local.properties to point to the directory where the Android SDK resides.
3. Use ant to build AndroWish from scratch: ant debug. This includes building the C libraries using Android NDK. That step can be performed separately by running ndk-build in the jni directory or by invoking ant ndk-build
4. The resulting Android APK is built to bin/AndroWish-debug.apk which can be installed onto a device or emulator using adb install -r bin/AndroWish-debug.apk.
5. Start AndroWish on device or emulator using adb from the development system: adb shell am start tk.tcl.wish/.AndroWishLauncher.
6. Clean the build tree with ant clean.

New style using gradlew:

1. Setup your environment regarding ANDROID_HOME and the ndk-build command e.g. by setting both a proper PATH and ANDROID_NDK_HOME.
2. Use gradlew to build AndroWish from scratch: ./gradlew assembleDebug. As above this performs both the NDK build and the final compile and packaging steps.
3. The resulting Android APK is built to build/outputs/apk/AndroWish-debug.apk which can be installed onto a device or emulator using adb install -r build/outputs/apk/AndroWish-debug.apk.
4. Start AndroWish on device or emulator using adb from the development system: adb shell am start tk.tcl.wish/.AndroWishLauncher.
5. Clean the build tree with ./gradlew clean.