-
Notifications
You must be signed in to change notification settings - Fork 116
Home
vimfung edited this page Nov 20, 2018
·
11 revisions
LuaScriptCore旨在能够在多种平台上方便地使用Lua。其提供了与多种平台的功能交互,让开发者无须关心Lua与各个平台之间是实现交互的细节,只需要根据自己的业务需求,使用LuaScriptCore提供的方法,轻松简单地实现各种功能。如:
- 原生代码调用Lua中的方法和变量,控制Lua的业务逻辑
如,Lua中有如下定义
url = "https://vimfung.github.io/LuaScriptCore/"; function printUrl(url) print (url); end
在原生代码中可以如下面操作Lua变量和方法:
iOS/OSX
//获取变量 LSCValue *urlValue = [context getGlobalForName:@"url"]; NSLog(@"url = %@", [urlValue toString]); //调用方法 [context callMethodWithName:"printUrl" arguments:@[urlValue]];
Android
//获取变量 LuaValue urlValue = context.getGlobal("url"); Log.d("LuaScriptCore", String.format("url = %s", urlValue.toString())); //调用方法 context.callMethod("printUrl", new LuaValue[] {urlValue});
Unity3D
//获取变量 LuaValue urlValue = context.getGlobal ("url"); Debug.LogFormat ("url = {0}", urlValue.toString ()); //调用方法 context.callMethod("printUrl", new List<LuaValue>(new LuaValue[] {urlValue}));
- Lua中调用原生提供的方法,让一些Lua无法处理或者耗时的处理交由原生方法实现
如,原生代码为Lua定义输出日志方法log:
iOS/OSX
[context registerMethodWithName:@"log" block:^LSCValue *(NSArray<LSCValue *> *arguments) { NSLog(@"%@", [arguments[0] toString]); return nil; }];
Android
context.registerMethod("log", new LuaMethodHandler() { @Override public LuaValue onExecute(LuaValue[] arguments) { Log.d("LuaScriptCore", arguments[0].toString()); return null; } });
Unity3D
LuaContext.currentContext.registerMethod("log", (List<LuaValue> arguments) => { Debug.Log(arguments[0].toString()); return null; });
在Lua中则可以调用该方法:
log("Hello World");
- 原生代码定义类型直接映射到Lua中使用,让Lua更方便地实现面向对象的编程
原生代码有如下类型定义:
iOS
@interface LuaType : NSObject <LSCExportType> // 定义属性和方法... @end
Android
class LuaType implements LuaExportType { // 定义属性和方法... }
Unity3D
class LuaType : LuaExportType { // 定义属性和方法... }
则可以在Lua中进行使用,如:
local obj = LuaType(); print (obj);
关于iOS/OS X平台下如何使用LuaScriptCore,请参考《iOS/OS X集成使用文档》
关于Android平台下如何使用LuaScriptCore,请参考《Android集成使用文档》
关于Unity3D下如何使用LuaScriptCore,请参考《Unity3D集成使用文档》
目前源码中不带有任何平台的Release库,在运行Sample时需要从Relases页签中下载最新版本的库并放入Sample项目后运行。
- iOS / OS X [Objective-C] [Swift]
- Android [Java]
- Unity3D [C#]
Release 2.3.0 - 下载
更新内容:
- 增加线程安全机制
- lua核心升级至5.3.5版本
- 修复Android平台下使用
ArrayList作为参数传入callMethod中无效问题。 - 允许Android、Unity平台下使用泛型作为参数传入lua。
- 修复Android平台下map中设置null元素转换失败问题
- Android和Unity平台下的
LuaExportTypeConfig和LuaExportTypeAnnotation标注过期(后续版本将移除),使用LuaExclude注解(特性)来代替:
Android平台
//调整前 @LuaExportTypeConfig(excludeExportInstanceMethodsNames = {"method1", "method2"}) class TargetClass implements LuaExportType { public void method1 () {} public void method2 () {} } //调整后 class TargetClass implements LuaExportType { @LuaExclude public void method1 () {} @LuaExclude public void method2 () {} }
Unity平台
//调整前 [LuaExportTypeAnnotation(excludeExportInstanceMethodNames=new string[]{"method1", "method2"})] class TargetClass : LuaExportType { public void method1 () {} public void method2 () {} } //调整后 class TargetClass : LuaExportType { [LuaExclude] public void method1 () {} [LuaExclude] public void method2 () {} }
如问题请与我联系
QQ技术讨论群
打开支付宝扫一扫,给予我支持
打开支付宝扫一扫