Android-Lua 整合指南与实践

Android-Lua 整合指南与实践

Android-Lua 项目地址: https://gitcode.com/gh_mirrors/and/Android-Lua

---

安装指南

要将 Android-Lua 添加到您的项目中，请确保您已更新至 Gradle 3.4.0 或更高版本，因为本库已迁移至 Maven Central。通过以下依赖项将其加入您的 build.gradle 文件：

dependencies {
    implementation "me.chenhe:android-lua:1.1.1"
}

对于 ProGuard 规则，若使用 R8，则无需额外配置；若使用其他混淆器，则需添加：

-keep class org.keplerproject.luajava.** { *; }

---

项目使用说明

初始化 Lua 运行环境

开始使用前，先初始化 LuaState：

LuaState lua = LuaStateFactory.newLuaState();
lua.openLibs();
// ... 使用后记得关闭
lua.close();

加载与执行 Lua 脚本

您可以直接执行 Lua 字符串或从文件加载脚本：

lua.LdoString("print('Hello, Lua!')");
// 或者加载文件：
lua.LdoFile("/path/to/your/script.lua");

数据交互

获取 Lua 变量

lua.getGlobal("variableName");
String value = lua.toString(-1);
lua.pop(1); // 清除栈顶元素

注入变量到 Lua

lua.pushString("Hello from Java");
lua.setGlobal("greeting");

遍历 Lua 表

lua.getGlobal("yourTable");
if (lua.isTable(-1)) {
    lua.pushNil(); // 开始遍历
    while (lua.next(-2) != 0) {
        String key = lua.toString(-2);
        String val = lua.toString(-1);
        Log.d("Traversal", key + ": " + val);
        lua.pop(1);
    }
    lua.pop(1);
}

调用 Lua 函数

lua.getGlobal("exampleFunction");
lua.pushString("parameter");
lua.pcall(1, 0, 0); // 调用函数，传入参数数量，期望返回值数量，错误处理函数索引

Lua 调用 Java 函数

实现 JavaFunction 并注册：

public class TimeProvider extends JavaFunction {
    @Override
    public int execute() {
        lua.pushString(LocalDateTime.now().toString());
        return 1;
    }
    
    public static void register(LuaState L) {
        try {
            new TimeProvider(L).register("getTime");
        } catch (LuaException e) {
            L.error(e.getMessage());
        }
    }
}

// 注册该功能
TimeProvider.register(lua);

注入 Java 对象

SomeJavaClass obj = new SomeJavaClass();
lua.pushJavaObject(obj);
lua.setGlobal("obj");

---

结语

以上介绍了 Android-Lua 的基本集成方法和一些核心功能的使用。通过本文档，开发者应能够快速上手，进一步探索 Lua 在 Android 应用中的强大潜能。务必参考官方 Lua 文档和项目Wiki，以挖掘更多高级特性和应用场景。祝编程愉快！

Android-Lua 项目地址: https://gitcode.com/gh_mirrors/and/Android-Lua