Unity HybridCLR 笔记

nnsix2026-05-11 9:29

🛠️ 准备工作

确保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 脚本，写入以下简单代码：

cs 复制代码

// Assets/HotUpdate/Hello.cs
using UnityEngine;

public class Hello
{
    public static void Run()
    {
        Debug.Log("Hello, HybridCLR");
    }
}

加载热更新程序集：

在主场景中创建一个挂载了 LoadDll.cs 脚本的游戏物体，该脚本负责加载 HotUpdate.dll 并通过反射调用其中的代码。

核心加载逻辑示例如下：

cs 复制代码

// 在非编辑器环境下，从文件加载热更新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，则说明整个环境搭建成功。