当前位置：首页 > news >正文

XLua教程之热补丁技术

news 2025/9/15 11:14:39

简介

热补丁是指在不重新安装游戏程序的前提下，使用Lua代码来快速修复线上出现bug的C#代码。

热补丁的优点与缺点

优点

1、替换整个方法体：这是最核心的功能，用 Lua 逻辑完全替换 C# 方法。

2、调用原方法：你可以在 Lua 补丁中选择是否调用原始的 C# 方法，并可以修改其参数和返回值。base 是 xLua 提供的关键字，用于调用原方法。

xlua.hotfix(CS.SomeClass, 'SomeMethod', function(self, arg1)print('Before calling original method')-- 调用原方法，并获取返回值local origResult = base(self, arg1)print('After calling original method. Result:', origResult)return origResult
end)

3、修补构造函数、属性、事件、泛型方法：xLua 支持修补各种类型的成员。

缺点

1、不支持添加新成员：不能通过热补丁给一个 C# 类添加全新的方法、字段或属性。只能替换已有的成员。

2、对性能有影响：被热补丁后的方法，其执行路径变长（需要进入Lua虚拟机），性能会比原生 C# 方法差。切忌对性能敏感的每帧执行的方法（如 Update）进行热补丁。

3、增加了包体大小：生成的热补丁支撑代码会使 IPA（iOS）或 APK（Android）的体积增大。

操作步骤

1、下载XLua文件包，准备好Xlua环境，可以参考

XLua教程之入门篇-CSDN博客

2、找到Edit=>Project Settings=>Player=>Other Settings=>Scripting Define Symbols,添加HOTFIX_ENABLE标签

3、复制xlua下载包的Tools文件夹，粘贴到工程Assets同级目录中

4、找到Assets/XLua/Src/Editor/Hofix.cs脚本

将脚本中下列代码替换成

 var inject_tool_path = Path.Combine(System.Environment.CurrentDirectory,"Tools\\XLuaHotfixInject.exe");
inject_tool_path = inject_tool_path.Replace("\\","/");

5、新建Main.lua.txt脚本、fix_bug.lua.txt脚本和XLuaManager.cs

Main.lua.txt

local Class = CS.HotFixTest
local test = Class()
test:Say()

fix_bug.lua.txt

xlua.hotfix(CS.HotFixTest, 'Say', function(self)print("被热补丁修复了")
end)

XLuaManager.cs

[Hotfix]
public class HotFixTest
{public void Say(){Debug.Log("Hello World!");}
}public class XLuaManager : MonoBehaviour
{LuaEnv luaEnv = null;void Start(){luaEnv = new LuaEnv();luaEnv.AddLoader(CustomLoader);luaEnv.DoString("require 'fix_bug'"); luaEnv.DoString("require ('Main')");}public byte[] CustomLoader(ref string filepath)  {//传入的参数是require执行的脚本文件名string path = Application.dataPath + "/LuaScripts/" + filepath + ".lua.txt";if (File.Exists(path))//判断该路径是否存在{return File.ReadAllBytes(path);}else{Debug.Log("未找到该文件!");}return null;}void Update(){// 每帧进行增量GC，平滑分摊GC开销if (luaEnv != null){luaEnv.Tick();}}void OnDestroy(){//在对象被销毁时，清理Lua环境if (luaEnv != null){luaEnv.Dispose();luaEnv = null; // 将其置为null是一个好习惯，防止后续误用}}
}

6、先清空（Clear Generated Code）再重新生成xlua插桩代码(Generate Code)，再热补丁注入(Hotfix Inject In Editor)