AndLua

Is a blend of jillcode, luaj, some additional android-specific classes and some custom Lua libraries. Allows to prototype Android apps within Android itself, without requiring the ADT.

Table of contents

• AndLua
  • Table of contents
    • Introduction
    • Features and limitations
    • Custom libraries
      • Android
        • android.activity
        • android.pwd
        • android.uptime([msec])
        • android.post(task, [msec])
        • android.remove([task id])
      • CryptLib
        • crypt.cipher
        • crypt.digest
        • crypt.iterations
        • crypt.password()
        • crypt.load(file name, password)
        • crypt.save(file name, password, plain text)
      • JavaLib
        • java.bind(class name)
        • java.new(class, arguments for constructor...)
        • java.proxy(interfaces..., table of functions)
    • Test programs
    • Links

Introduction

Features and limitations

Compiles and executes Lua scripts on the fly. The included luajava-like library allows access to a large chunk of Android's capabilities.

It is not possible to sub-class existing java classes and this approach doesn't abstract the Android platform.

Custom libraries

A minimal set of functions necessary to interact with the Android environment.

Android

android.activity

Instance of the currently running android Activity.

android.pwd

android.uptime([msec])

If msec is given, sets the interpreter uptime value to msec. Otherwise returns the current interpreter uptime. The time unit is always milliseconds.

android.post(task, [msec])

Task must be a reference to something the interpreter can call like a function. If msec is given, task is scheduled be called as soon as the interpreter's uptime value reaches the value given by the msec parameter. Otherwise task will be scheduled to be called as soon as possible. Returns a task id object on success, nothing on failure.

android.remove([task id])

If task id is given, removes the specified task from the background execution queue. Otherwise removes all tasks from the queue.

CryptLib

Very simple cryptography-oriented functions.

crypt.cipher

Name of the cipher algorithms to use. Defaults to "PBEWithMD5AndDES".

crypt.digest

Name of the digest algorithm to use to check for integrity and successful decryption. Defaults to "MD5".

crypt.iterations

Defaults to 64.

crypt.password()

Returns a new random password.

crypt.load(file name, password)

Loads cipher text from disk. Returns boolean true and the decrypted content on success, false and an error message on failure.

crypt.save(file name, password, plain text)

Writes cipher text to disk. Returns boolean true on success, false and an error message on failure.

JavaLib

Simplified version of the LuaJava API adapted from luaj.

java.bind(class name)

Returns a Lua object linked to the named class on success, nil on failure.

java.new(class, arguments for constructor...)

Returns a Lua object linked to a new instance of the class on success, generates an exception on failure.

java.proxy(interfaces..., table of functions)

Instantiates and implements some java interfaces.

Test programs

Compile the project or install the apk, upload the "andlua" folder from "ball.zip" inside your "/sdcard/" and navigate to it using the in-app file selector.

Links

Project page