🛠️ 准备工作
确保Unity 安装开发模块:
Windows Build Support (IL2CPP)或Mac Build Support (IL2CPP)。- Windows:需要安装Visual Studio 2019或更高版本,并确保包含了“使用Unity的游戏开发”和“使用C++的游戏开发”两个组件。同时需要安装Git。
- Mac:需要安装Xcode(版本13或以上)和Git。
一、安装与配置HybridCLR
1、安装 HybridCLR包
包管理 - 使用 Git地址 (https://gitee.com/focus-creative-games/hybridclr_unity.git)安装HybridCLR包
2、初始化 HybridCLR:
菜单栏HybridCLR-Installer -控制台输出Installation Successful
3、项目设置:
① Scripting Backend:必须设置为IL2CPP。
② Api Compatibility Level:设置为.Net 4.x(Unity 2019-2020)或.Net Framework(Unity 2021及以上版本)。
二、编写与测试热更新代码
环境配置完毕,接下来通过一个简单测试来验证效果。
创建热更新模块:
在
Assets目录下创建一个新文件夹,例如HotUpdate。在
HotUpdate文件夹上右键,选择Create -> Assembly Definition,创建一个名为HotUpdate的程序集定义文件。
编写测试脚本:
在
HotUpdate文件夹中创建Hello.cs脚本,写入以下简单代码:// Assets/HotUpdate/Hello.cs using UnityEngine; public class Hello { public static void Run() { Debug.Log("Hello, HybridCLR"); } }
加载热更新程序集:
在主场景中创建一个挂载了
LoadDll.cs脚本的游戏物体,该脚本负责加载HotUpdate.dll并通过反射调用其中的代码。核心加载逻辑示例如下:
// 在非编辑器环境下,从文件加载热更新DLL Assembly hotUpdateAss = Assembly.Load(File.ReadAllBytes($"{Application.streamingAssetsPath}/HotUpdate.dll.bytes")); // 通过反射执行热更新代码 Type type = hotUpdateAss.GetType("Hello"); type.GetMethod("Run").Invoke(null, null);
构建与测试:
HybridCLR -> Settings,将热更新的程序集(Assembly)HotUpdate添加到列表中。运行
HybridCLR/Generate/All菜单进行必要的生成操作。将项目 HybridCLRData / HotUpdateDlls 下的生成的
HotUpdate.dll文件再加个.bytes后缀名,并放入StreamingAssets文件夹。进行打包构建,如果控制台成功打印出
Hello, HybridCLR,则说明整个环境搭建成功。