跳到主要内容

项目状态与路线图

当前状态​

:::info Alpha · 双运行时进度不同 ZLua 在 Unity 2022.3.62f3 + Lua 5.4 上测试通过。

运行时环境状态
MonoUnity Editorv1.0 功能已全部实现，适合完整功能开发与验证
Il2CppPlayer 发布MVP 阶段，仅实现 Demo 所需的基础互操作

Il2Cpp 正式版（完整 C++ 直桥与性能优化）预计 2026 年 8 月 发布。 :::

:::tip 开发建议 日常开发、API 验证请在 Editor（Mono） 下进行；构建 Player 前请对照下方 Il2Cpp 已支持清单 确认依赖能力是否可用。 :::

我应该在哪里开发 / 测什么？​

场景建议
新项目原型、热更逻辑Editor Mono，clone zlua-demo
验证 Player 可行性仅用 app.lua 同等能力
性能对比 xLua等待 Il2Cpp 完整版；当前 MVP 不具代表性
查完整 API 语义Mono 行为 + 规范文档

Mono（Editor）— 已实现​

Lua 调用 C#​

  • 访问 class、struct 类
  • 访问成员变量和静态成员变量
  • 调用函数和静态函数
  • 函数重载（dispatch、get_method、[LuaAlias]）
  • Property（含 index 访问器）
  • Event
  • 泛型类与泛型函数
  • Array 等集合类型

C# 调用 Lua​

  • [LuaInvoke]

Marshal​

  • 值类型、string、class、struct、enum、array
  • 指针、函数指针、TypedReference
  • in / out / ref
  • [LuaMarshalAs]

其他​

  • zlua 标准库（typeof、make_generic_type 等）
  • Mono 侧性能优化
  • 测试框架与用例

Il2Cpp（Player）— 当前已支持（MVP）​

已支持​

  • [LuaInvoke]
  • class 访问与构造（Demo 范围）
  • 实例 / 静态字段访问
  • 实例 / 静态方法调用（手写桥接，常见签名）
  • 基础类型：int、bool、string、void

尚未支持​

  • struct 完整互操作
  • 函数重载 / zlua.get_method
  • Property、Event
  • 泛型、Array
  • enum、delegate、ref/out/in
  • 全量 MethodBridge 自动生成
  • 设计目标中的 C++ 性能优化

详见 Il2Cpp 架构 与 路线图。

v1.0 总目标​

Il2Cpp Player 追平 Mono 已实现的全量功能，并完成 C++ 直桥性能优化。

v2.0 计划​

  • Unity 2021+ LTS、团结引擎
  • Lua 5.1 / 5.3+ / LuaJIT / Luau
  • xLua / tolua 迁移指南

下一步​