第17章 Lua与UE集成热更新

考点： Lua C API、绑定原理、内存管理

参考答案：

1. Lua与C++通过栈交换数据，所有交互都经过 lua_State*：

   • 压入值：lua_pushinteger/lua_pushstring/lua_pushboolean；
   • 取值：lua_tointeger/lua_tostring（负数下标从栈顶开始，-1 为栈顶）；
   • 调用 Lua 函数：lua_getglobal 取函数 → lua_pushinteger 压参 → lua_pcall(L, 1, 1, 0) → lua_tointeger(L, -1) 取返回值。

2. UE 绑定原理：C++ 类注册到 Lua 使用 metatable + userdata：

   • luaL_newmetatable 创建元表；
   • 将 __index 设为元表自身，使表查找能命中已注册方法；
   • 用 luaL_Reg 注册方法，方法内通过 lua_touserdata(L, 1) 取回 C++ 对象指针（self）；
   • 用 luaL_setfuncs 批量绑定方法。

void BindMyClass(lua_State* L)
{
    luaL_newmetatable(L, "MyClass");
    lua_pushvalue(L, -1);
    lua_setfield(L, -2, "__index");

    luaL_Reg methods[] = {
        {"GetName", [](lua_State* L) -> int {
            AMyActor* Self = (AMyActor*)lua_touserdata(L, 1);
            lua_pushstring(L, *Self->GetName());
            return 1;
        }},
        {NULL, NULL}
    };
    luaL_setfuncs(L, methods, 0);
    lua_pop(L, 1);
}

3. 内存管理：UE 对象被 GC 后 Lua 侧引用需失效：
   • 用弱引用表（__mode 设为 "v" 弱值）存 UE 对象，对象被回收时 Lua 侧条目自动失效；
   • C++ 侧用 TWeakObjectPtr 防止悬空引用。

lua_newtable(L);                 // 弱引用表
lua_newtable(L);                 // metatable
lua_pushstring(L, "__mode");
lua_pushstring(L, "v");          // 弱值
lua_settable(L, -3);
lua_setmetatable(L, -2);

4. 易错点：userdata 与 lightuserdata 的区别（后者不参与 GC）；lua_pcall 返回值 0 表示成功，非 0 为错误码，需配合错误处理函数。

考点： 技术选型、框架对比、性能分析

参考答案：

1. Puerts（腾讯）：

   • 支持 TypeScript/JavaScript 与 Lua，JS 走 V8 引擎、Lua 走 LuaJIT；
   • 绑定代码自动生成，TypeScript 提供强类型；
   • 社区活跃，适合有前端背景的团队。

2. sluaunreal（腾讯开源）：

   • 纯 Lua 绑定方案，使用 LuaJIT；
   • 手动/自动绑定混合，弱类型；
   • 社区活跃度较低，学习曲线低（纯 Lua），适合熟悉 Lua 的团队。

3. C++ 注册 Lua 可调用函数示例（Puerts）：

void UMyClass::RegisterLuaAPI()
{
    auto L = puerts::FEnv::GetLuaState();
    lua_register(L, "SpawnActor", [](lua_State* L) -> int {
        FString ClassName = lua_tostring(L, 1);
        // 执行逻辑
        return 1;
    });
}

local Actor = SpawnActor("BP_MyActor")
Actor:SetActorLocation(FVector(100, 0, 0))

4. 选型建议：团队有前端背景选 Puerts（TypeScript 强类型利于大型项目）；团队熟悉 Lua 选 sluaunreal/UnLua。另外 UnLua 对 UE 反射机制结合更好，蓝图/逻辑层兼容性强，也是常见选项。

考点： 热更新需求、技术选型、架构设计

参考答案：

1. 为什么需要 Lua：

   • 热更新：移动平台审核周期长，可不发版本修复 Bug；
   • 快速迭代：Lua 无需编译，修改即生效；
   • 策划友好：语法简单，策划可直接写逻辑；
   • 安全性：Lua 代码可加密，比蓝图更难反编译；
   • 跨平台：同一份 Lua 代码在 iOS/Android/PC 通用。

2. 热更新架构分层（自下而上）：C++ 框架层（引擎核心、渲染、网络）→ Lua 绑定层（Puerts/sluaunreal）→ Lua 虚拟机（LuaJIT）→ 游戏逻辑/UI/配置层（Lua）。

3. C++ 侧初始化虚拟机并加载 Lua 入口：

void UGameInstance::InitLua()
{
    lua_State* L = luaL_newstate();
    luaL_openlibs(L);
    BindUEToLua(L);
    luaL_dofile(L, "scripts/main.lua");
}

-- main.lua
local GameMain = {}
GameMain.__index = GameMain

function GameMain:Init()
    self:LoadConfig()
    self:InitUI()
end

function GameMain:LoadConfig()
    self.Config = require("config.game_data")  -- 配置表可热更新
end

return GameMain

4. 追问"为什么不用蓝图做热更新"：蓝图无法运行时热更新，且蓝图可被反编译，安全性不如加密后的 Lua。

考点： 热更新流程、安全性、版本管理

参考答案：

1. 完整流程（五步）：

   • 版本检查：客户端请求服务器最新版本号，与本地对比判断是否更新；
   • 下载更新包：增量更新只下载差异文件（bsdiff/bspatch），下载时做完整性校验（MD5/SHA256）；
   • 解压与替换：解压到临时目录、校验文件完整性后再替换旧文件；
   • 加载新代码：重新加载 Lua 入口文件并重初始化逻辑，保持游戏状态不重启；
   • 回滚机制：更新失败时回滚旧版本，保留旧版本备份。

2. 安全性保障：

   • 代码加密：Lua 源码先编译为字节码（lua_dump）再 AES 加密；
   • 签名校验：计算文件 SHA256 与服务器下发的签名比对，防篡改；
   • 传输安全：使用 HTTPS；
   • 代码混淆：变量名替换、控制流混淆。

// 编译为字节码后加密
luaL_loadstring(L, TCHAR_TO_UTF8(*Content));
lua_dump(L, WriteCallback, &Buffer);
TArray<uint8> Encrypted = AES_Encrypt(Buffer, EncryptionKey);
FFileHelper::SaveArrayToFile(Encrypted, *OutputPath);

// 签名校验
FString ActualSignature = FSHA256Hash::HashFile(FilePath);
return ActualSignature == ExpectedSignature;

3. Lua 侧模块热替换：清 package.loaded[moduleName] 缓存后 pcall(require, ...) 重新加载，失败则回滚；替换时只更新函数、保留旧模块状态。

function HotFix:ReloadModule(moduleName)
    package.loaded[moduleName] = nil
    local ok, newModule = pcall(require, moduleName)
    if ok then
        self:ReplaceModule(moduleName, newModule)
    else
        self:Rollback(moduleName)   -- 加载失败回滚
    end
end

4. 易错点：热更新不只是"替换文件"，必须处理模块缓存、对象旧引用、状态保持与失败回滚；更新包需做版本号/校验和双重校验。