在Android中使用Lua脚本 —— Programing Lua on Android

Android是基于Linux 2.6 内核的系统，所以理论上Linux OS可以运行的脚本语言，给予相应的运行库，在Android也可以运行。

在Android手机上编写并运行Lua脚本

利用开源项目SL4A ( Scripting Layer for Android 项目地址：http://code.google.com/p/android-scripting/ ) ，可以快速在Android手机上搭建各种脚本运行环境。目前SL4A支持 Python, Perl, JRuby, Lua, BeanShell, JavaScript, Tcl, shell 等脚本语言 。

1、下载并安装SL4A运行环境

    最新 sl4a_r6.apk 下载地址：http://android-scripting.googlecode.com/files/sl4a_r6.apk

    这个应用提供了各种脚本的运行环境，通过拆APK可以看到应用内嵌了两个.so动态链接库。其中一个是ConnectBot的库，另一个是7.9K大小的脚本执行库，但显然不是脚本语言解析库。具体关于SL4A的原理，可以参考博文：《SL4A 之实现原理解析》

2、下载 Lua for android 支持

    lua_for_android_r1.apk 下载地址：http://android-scripting.googlecode.com/files/lua_for_android_r1.apk

3、运行Lua for android ，它将从网络下载一些Lua脚本Demo。这些例子在SL4A中运行。

   

使用SL4A可以在Android手机上直接运行Lua等脚本。

其它脚本语言，可以到 http://code.google.com/p/android-scripting/downloads/list 下载相应的APK。

在Android项目中使用Lua脚本

SL4A 交互式的脚本运行方式不适合在Android项目中使用。如果你的项目要使用Lua脚本，就需要将Lua嵌入到Android项目中。

在Android项目中使用Lua，需要两个步骤：

1、加载Lua脚本解析引擎。

2、以Native API方式调用引擎接口

直接以JNI方式调用Lua解析引擎的接口十分麻烦，开源项目LuaJava对这些JNI接口进行了很好的封装。

AndroLua是一个包含了LuaJava的Android平台的Lua解析器，它提供一系列映射到Lua C实现函数的Java接口。

项目地址：  https://github.com/mkottman/AndroLua 

1、用Git将项目克隆到Eclipse的工作目录中

     git clone  https://github.com/mkottman/AndroLua.git

2、AndroLua项目包含了LuaJava的C源码在JNI目录中。用Android NDK编译。编译结束，在libs\armeabi目录下生成LuaJava的动态链接库文件。

       

    编译结束。 

3、创建几个演示例程。这里演示三种使用Lua脚本的方式。

        将上面从GitHub中克隆回来的项目导入到Eclipse中。创建一个Activity。 

        

01 public class MainActivity extends Activity {
02     //Lua解析和执行由此对象完成
03     private LuaState mLuaState;
04     //用于演示，显示数据
05     private TextView mDisplay;
06     //用于演示
07     private LinearLayout mLayout;
08
09         @Override
10     protected void onCreate(Bundle savedInstanceState) {
11
12         super.onCreate(savedInstanceState);
13         setContentView(R.layout.activity_main);
14
15         mLayout = (LinearLayout) findViewById(R.id.layout);
16         mDisplay = (TextView) mLayout.findViewById(R.id.display);
17
18         mLuaState = LuaStateFactory.newLuaState();
19         mLuaState.openLibs();
20     }
21
22     public void runStatement(View v) {
23         // 定义一个Lua变量
24         mLuaState
25                 .LdoString(" varSay = 'This is string in lua script statement.'");
26         // 获取
27         mLuaState.getGlobal("varSay");
28         // 输出
29         mDisplay.setText(mLuaState.toString(-1));
30     }
31
32 public void runFile(View v) {
33         mLuaState.LdoString(readStream(getResources().openRawResource( R.raw.test)));
34         // 找到functionInLuaFile函数
35         mLuaState.getField(LuaState.LUA_GLOBALSINDEX, "functionInLuaFile");
36         // 将参数压入栈
37         mLuaState.pushString("从Java中传递的参数");
38
39         // functionInLuaFile函数有一个参数，一个返回结果
40         int paramCount = 1;
41         int resultCount = 1;
42         mLuaState.call(paramCount, resultCount);
43 // 将结果保存到resultKey中
44         mLuaState.setField(LuaState.LUA_GLOBALSINDEX, "resultKey");
45         // 获取
46         mLuaState.getGlobal("resultKey");
47         // 输出
48         mDisplay.setText(mLuaState.toString(-1));
49     }
50
51 public void callAndroidAPI(View v) {
52         mLuaState.LdoString(readStream(getResources().openRawResource( R.raw.test)));
53         // 找到functionInLuaFile函数
54         mLuaState.getField(LuaState.LUA_GLOBALSINDEX, "callAndroidApi");
55
56         mLuaState.pushJavaObject(getApplicationContext());
57         mLuaState.pushJavaObject(mLayout);
58         mLuaState.pushString("设置到TextView的数据");
59         mLuaState.call(3, 0);
60     }
61
62 private String readStream(InputStream is) {
63         try {
64             ByteArrayOutputStream bo = new ByteArrayOutputStream();
65             int i = is.read();
66             while (i != -1) {
67                 bo.write(i);
68                 i = is.read();
69             }
70             return bo.toString();
71         } catch (IOException e) {
72             Log.e("ReadStream", "读取文件流失败");
73             return "";
74         }
75     }
76 }

Lua文件：

01 //此函数由Java代码调用。接受一个参数，并返回一个字符串
02 function functionInLuaFile(key)
03      return ' Function in Lua file . Return : '..key..'!'
04 end
05
06 //此函数由Java代码调用。接受三个参数。并调用这些Android组件的方法。
07 function callAndroidApi(context,layout,tip)
08     //创建一个Android TextView
09     tv = luajava.newInstance("android.widget.TextView",context)
10
11     //调用TextView的方法
12     tv:setText(tip)
13
14     //调用Layout的方法
15     layout:addView(tv)
16 end

XML布局文件：

01 xml version="1.0" encoding="utf-8"?>
02 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
03     android:id="@+id/layout"
04     android:layout_width="match_parent"
05     android:layout_height="match_parent"
06     android:orientation="vertical" >
07
08 <TextView
09         android:id="@+id/display"
10         android:layout_width="wrap_content"
11         android:layout_height="wrap_content" />
12
13     <Button
14         android:id="@+id/statemanet"
15         android:layout_width="match_parent"
16         android:layout_height="wrap_content"
17         android:onClick="runStatement"
18         android:text="运行Lua脚本语句" />
19
20 <Button
21         android:id="@+id/file"
22         android:layout_width="match_parent"
23         android:layout_height="wrap_content"
24         android:onClick="runFile"
25         android:text="运行Lua脚本文件" />
26
27     <Button
28         android:id="@+id/callAndroid"
29         android:layout_width="match_parent"
30         android:layout_height="wrap_content"
31         android:onClick="callAndroidAPI"
32         android:text="调用 Android API" />
33 LinearLayout>

效果截图：