File List
Not logged in

Files of check-in [b7d5683527] in directory sdktools   [history]


================================================================================
AndroWish SDK - Tcl/Tk 8.6 port for Android
================================================================================

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 the port works
================================================================================

- Android applications are Java-based, optionally with parts written in C
- As Tcl/Tk is C-based, a layer using JNI is used to interface to the Java
  universe
- This means that C code is placed inside an Android Java project, along
  with some C support code that communicates with Java
- The drawing on screen and event handling is performed using SDL (included),
  AGG (included), and Freetype (included)
- The C code is precompiled for ARM and x86 processors and located
  below the lib/armeabi and lib/x86 directories
- This eventually produces a standard Android .apk package

================================================================================
 Building and running an AndroWish based App
================================================================================

Tool based:

- Execute "tools/bones", it is a wish script. Detailed instructions can
be found on http://www.androwish.org/index.html/wiki?name=AndroWish+SDK

Manually (both ant and gradle are supported):

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

3a. Use ant to build an AndroWish based APK:

   ant debug  or  ant release

3b. Use gradle to build an AndroWish based APK:

   gradlew assembleDebug  or  gradlew assembleRelease

4a. Install APK on emulator or device:

   adb install -r bin/AndroWishApp-debug.apk

4b. Install APK on emulator or device:

   adb install -r build/outputs/apk/AndroWishApp-debug.apk

5. Start APK on emulator or device using adb from development system:

   adb shell am start <your-package-name>/.<your-app-name>

6a. Clean the build tree:

   ant clean

6b. Clean the build tree:

   gradlew clean

================================================================================
Download URLs for Android SDK Tools
================================================================================

For version 22.6.4

Windows:  http://dl-ssl.google.com/android/repository/tools_r22.6.4-windows.zip
Mac:      http://dl-ssl.google.com/android/repository/tools_r22.6.4-macosx.zip
Linux:    http://dl-ssl.google.com/android/repository/tools_r22.6.4-linux.zip

For Version 23.0.5

Windows:  http://dl-ssl.google.com/android/repository/tools_r23.0.5-windows.zip
Mac:      http://dl-ssl.google.com/android/repository/tools_r23.0.5-macosx.zip
Linux:    http://dl-ssl.google.com/android/repository/tools_r23.0.5-linux.zip

For Version 24.4.1

Windows:  http://dl-ssl.google.com/android/repository/tools_r24.4.1-windows.zip
Mac:      http://dl-ssl.google.com/android/repository/tools_r24.4.1-macosx.zip
Linux:    http://dl-ssl.google.com/android/repository/tools_r24.4.1-linux.zip

For Version 25.2.5

Windows:  http://dl-ssl.google.com/android/repository/tools_r25.2.5-windows.zip
Mac:      http://dl-ssl.google.com/android/repository/tools_r25.2.5-macosx.zip
Linux:    http://dl-ssl.google.com/android/repository/tools_r25.2.5-linux.zip

And so on ...