================================================================================
tcltkapplib - Android library project to re-use AndroWish runtime
================================================================================

Requirements:

Android SDK (version 12 or later)
http://developer.android.com/sdk/index.html

Minimum API level supported by SDL: 10 (Android 2.3.3)
Requested API level from project.properties: 14 (Android 4.0)
CPUs supported for native shared libraries (jni/Application.mk): armeabi x86
Joystick support is available for API level >=12 devices.

================================================================================
 How it works
================================================================================

- This library project contains an alternative implementation of
  the tk.tcl.wish.AndroWish class and supplementary classes which use
  an installed AndroWish package w.r.t. its assets folder and its
  shared libraries
- It can be incorporated into Android apps to use AndroWish's runtime

The Android Java code implements an "Activity" and can be found in:

src/tk/tcl/wish/AndroWish.java
src/org/libsdl/app/SDLActivity.java

================================================================================
 Building the package
================================================================================

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 Android SDK resides

3. Use ant to build the project:

      ant debug
   or
      ant release

4. Copy the resulting bin/classes.jar into the libs folder of your
   Android project as tcltkapplib.jar

5. Clean the build tree:

   ant clean

