跳到主要内容

支持的版本与平台

如何理解支持范围​

支持策略不代表所有引擎 / Unity / 操作系统组合都已实测。Luau 有分支限制,PUC-Rio 平台列表描述设计覆盖;公开性能报告仅对应 Win64 Il2Cpp / Unity 2022.3.62f3。发布前仍须在目标平台运行正确性测试与构建冒烟。补充平台验证记录时,应附包版本、Unity / Lua 版本、设备与测试报告。

Lua 引擎​

版本Mono (Editor)Il2Cpp (Player)备注
Lua 5.1.x✅✅Settings 可选(如 lua-5.1.5);无 VM FastMT patch
Lua 5.2.x✅✅Settings 可选(如 lua-5.2.4);无 VM FastMT patch
Lua 5.3.x✅✅Settings 可选;默认 lua-5.5.0
Lua 5.4.x✅✅Settings 可选
Lua 5.5.x✅✅Settings 可选
LuaJIT✅⚠️Editor(Mono)可用;Il2Cpp Player 仅 Android / iOS(须自备静态库,见 LuaJIT 构建)
Luau✅✅官方仓库 luau 分支。Editor 仅 Windows;Il2Cpp 当前 Windows x64。见下方

PUC-Rio 小版本用 Settings 的 luaVersionId(lua-X.Y.Z)指定;LuaJIT 用 luajit-M.N;Luau 用 luau-M.N(如 luau-0.743)。Install 时装入本地树。详见 安装、多版本管理。

Luau​

实现在官方仓库 luau 分支(尚未合入 main)。UPM 依赖写成 https://github.com/focus-creative-games/zlua.git#luau,Settings luaVersionId 设为 luau-M.N(例如 luau-0.743,对应 luau-lang/luau 的同名 tag)。

Install 会浅克隆该 tag 到 Library/ZLua/LuaSrcCache/luau-M.N/,只把公共头(lua.h、luaconf.h、lualib.h、luacode.h)装入 libil2cpp/lua,并用 CMake + Visual Studio 2022(x64) 编译 Win64 静态库,经 generated/LuauLink.inc 链进 Il2Cpp。本机需要 git、CMake 和 Visual Studio 2022。不应用 patches/lua,且 ZLUA_FAST_METATABLE 为 0。

Luau 的 luaL_openlibs 不带 package / require / loadstring。ZLua 在开库后补上 package、require、load 与 loadstring。

Editor(Mono)可用,且仅 Windows。 其它桌面系统上的 Editor 不在当前支持范围内。Il2Cpp 目前只链 Win64 静态库,其它 Player 目标平台同样不在这次构建范围内。

Unity​

最低支持 Unity 2022.3 LTS;后续仅支持 LTS 系列,以及基于 Unity 2022.3.x 的团结引擎。Unity 2021 及更早版本、非 LTS 的 Update/Tech Stream 不在支持范围。

版本状态
Unity 6.0 LTS 6000.0.x✅ 支持
Unity 6.3 LTS 6000.3.x✅ 支持
Unity 2022.3 LTS✅ 支持
团结引擎 LTS✅ 支持

libil2cpp patch 解析:优先 patches/libil2cpp/6000.{minor}/,再回退 6000/(见 多版本管理)。

Scripting Backend​

后端环境功能状态
Il2CppPlayer 发布已完成(权威实现)
MonoUnity Editor已完成(与 Il2Cpp 语义一致)

Lua 可见语义两端一致;Indexer / 桥接实现不同。详见 项目状态、规范。

Il2Cpp 构建: 发布前执行 ZLua/Generate/All(C++ stub,非 C# Wrap)。

目标平台(Il2Cpp)​

引擎Il2Cpp Player 平台
PUC-Rio(Lua 5.1–5.5)设计覆盖 Il2Cpp 常见目标(Windows、macOS、iOS、Android、WebGL、微信小游戏、鸿蒙/车机等)
LuaJIT仅 Android、iOS;Win / macOS / Linux / WebGL 等 不支持。须自行编译静态 .a 放入 Plugins,见 LuaJIT 构建
Luauluau 分支:Editor 仅 Windows;Il2Cpp 当前 Windows x64(Install 编译并链接静态库)

其它平台问题请提交 Issue。


功能 × 运行时矩阵​

✅ 可用 · ⚠️ 有限制(见说明) · ❌ 不支持(有意限制)。细则以 规范 为准。

Lua 调用 C#​

功能MonoIl2Cpp说明
class / struct 访问✅✅懒绑定,无 C# Wrap 白名单
实例 / 静态字段✅✅
实例 / 静态方法✅✅
Property(无参)✅✅
Property(indexer)✅✅经 get_Item / set_Item 等方法形式访问,见 字段与属性
方法重载 dispatch✅✅
[LuaAlias] / 全签名键✅✅短名仅 Bind 期别名;无运行时 register_method
泛型类 / 泛型方法✅✅开放泛型须先闭合;静态泛型方法有限制
Array(szarray / mdarray)✅✅mdarray 不可 table 序列化
Event 专用元表❌❌使用 add_ / remove_ 普通方法
Delegate / Lua 回调✅✅Lua→C# byref 形参有限制

C# 调用 Lua​

功能MonoIl2Cpp
GetFunction<T>✅✅
多参数 / 返回值✅✅
[LuaMarshalAs]✅✅

Marshal​

类型MonoIl2Cpp
基元 / string✅✅
enum(默认 integer)✅✅
class / struct(ByVal / ByObj / Opaque)✅✅
array✅✅
OpaqueValue / byref✅✅

标准库 zlua​

APIMonoIl2Cpp
typeof / get_type_from_name / make_generic_type✅✅
inflate / GTAP✅✅
szarray / mdarray 工厂✅✅
opaque get/set、box/unbox✅✅

开发环境建议​

目标推荐环境
功能开发、脚本迭代Editor(Mono)
发布与性能Il2Cpp Player + Generate
语义争议以 spec 为准

下一步​