21 Star 95 Fork 2

Gitee 极速下载 / xlua

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
此仓库是为了提升国内下载速度的镜像仓库,每日同步一次。 原始仓库: https://github.com/Tencent/xLua
克隆/下载
features.md 4.20 KB
一键复制 编辑 原始数据 按行查看 历史
SlimeNull 提交于 2024-04-19 11:53 . docs: 优化文档内容 (#1108)

特性

总体

  • Lua虚拟机支持
    • Lua5.3
    • Luajit2.1
  • Unity3D版本支持
    • 各版本均支持
  • 平台支持
    • windows 64/32
    • android
    • ios 64/32/bitcode
    • osx
    • uwp
    • webgl
  • 互访技术
    • 生成适配代码
    • 反射
  • 易用性
    • 解压即可用
    • 开发期无需生成代码
    • 生成代码和反射间可无缝切换
    • 更简单的无GC api
    • 菜单简单易懂
    • 配置可以多份,按模块划分,也可以直接在目标类型上打Attribute标签
    • 自动生成link.xml防止代码剪裁
    • Plugins部分采用cmake编译,更简单
    • 核心代码不依赖生成代码,可以随时删除生成目录
  • 性能
    • Lazyload技术,避免用不上的类型的开销
    • lua函数映射到c# delegate,lua table映射到interface,可实现接口层面无C# gc alloc开销
    • 所有基本值类型,所有枚举,字段都是值类型的struct,在Lua和C#间传递无C# gc alloc
    • LuaTable,LuaFunction提供无gc访问接口
    • 通过代码生成期的静态分析,生成最优代码
    • 支持C#和Lua间指针传递
    • 自动解除已经Destroy的UnityEngine.Object的引用
  • 扩展性
    • 不用改代码就可以加入Lua第三方扩展
    • 生成引擎提供接口做二次开发

支持为如下C#实现打补丁

  • 构造函数
  • 析构函数
  • 成员函数
  • 静态函数
  • 泛化函数
  • 操作符重载
  • 成员属性
  • 静态属性
  • 事件

Lua代码加载

  • 加载字符串
    • 支持加载后立即执行
    • 支持加载后返回一个delegate或者LuaFunction,调用delegate或者LuaFunction后可传脚本参数
  • Resources目录的文件
    • 直接require
  • 自定义loader
    • Lua里头require时触发
    • require参数透传给loader,loader读取Lua代码返回
  • Lua原有的方式
    • Lua原有的方式都保留

Lua调用C#

  • 创建C#对象
  • C#静态属性,字段
  • C#静态方法
  • C#成员属性,字段
  • C#成员方法
  • C#继承
    • 子类对象可以直接调用父类的方法,访问父类属性
    • 子类模块可以直接调用父类的静态方法,静态属性
  • 扩展方法(Extension methods)
    • 就像普通成员方法一样使用
  • 参数的输入输出属性(out,ref)
    • out对应一个lua返回值
    • ref对应一个lua参数以及一个lua返回值
  • 函数重载
    • 支持重载
    • 由于lua数据类型远比C#要少,会出现无法判断的情况,可通过扩展方法来来调用。
  • 操作符重载
    • 支持的操作符:+,-,*,/,==,一元-,<,<=, %,[]
    • 其它操作符可以借助扩展方法调用
  • 参数默认值
    • C#参数有默认值,在lua可以不传
  • 可变参数
    • 在对应可变参数部分,直接输入一个个参数即可,不需要把这些参数扩到一个数组里头
  • 泛化方法调用
    • 静态方法可以自行封装使用
    • 成员函数可通过扩展方法封装使用
  • 枚举类型
    • 数字或字符串到枚举的转换
  • delegate
    • 调用一个C# delegate
    • +操作符
    • -操作符
    • 把一个lua函数作为一个c# delegate传递给c#
  • event
    • 增加事件回调
    • 移除事件回调
  • 64位整数
    • 传递无gc而且无精度损失
    • lua53下使用原生64位支持
    • 可以和number运算
    • 以java的方式支持无符号64位整数
  • table的自动转换到C#复杂类型
    • obj.complexField = {a = 1, b = {c = 1}},obj是一个C#对象,complexField是两层嵌套的struct或者class
  • typeof
    • 对应C#的typeof操作符,返回Type对象
  • lua侧直接clone
  • decimal
    • 传递无gc而且无精度损失

C#调用Lua

  • 调用Lua函数
    • 以delegate方式调用Lua函数
    • 以LuaFunction调用lua函数
  • 访问Lua的table
    • LuaTable的泛化Get/Set接口,调用无gc,可指明Key,Value的类型
    • 用标注了CSharpCallLua的interface访问
    • 值拷贝到struct,class

Lua虚拟机

  • 虚拟机gc参数读取及设置

工具链

  • Lua Profiler
    • 可根据函数调用总时长,平均每次调用时长,调用次数排序
    • 显示lua函数名及其所在文件的名字及行号
    • 如果C#函数,会显示这个是C#函数
  • 支持真机调试
C
1
https://gitee.com/mirrors/xlua.git
git@gitee.com:mirrors/xlua.git
mirrors
xlua
xlua
master

搜索帮助