HybridCLR 热更新技术浅谈

📖一、HybridCLR 概述

1.1 什么是 HybridCLR

HybridCLR（原 Huatuo）是 Unity IL2CPP 的扩展方案，在保留 IL2CPP 性能优势的同时，增加了代码热更新能力。

1.2 能否热更新 AOT 中的逻辑？

⚙️二、核心原理

2.1 架构图

2.2 核心组件

IL 解释器

• 作用：逐条解释执行 IL 字节码
• 实现语言：C++（解释器本身是原生代码）
• 执行内容：IL 字节码（热更新 DLL 中的代码）

元数据注册

将热更新程序集的类型信息注册到 IL2CPP 的元数据系统，使 AOT 代码可以通过反射等方式调用热更新代码。

2.3 执行流程

2.4 与其他方案对比

📦三、DLL 基础知识

3.1 什么是 DLL

DLL = Dynamic Link Library（动态链接库）

DLL 是把代码打包成一个文件，供其他程序调用使用的"代码包"。

3.2 两种 DLL 类型

3.3 原生 DLL 效率对比

为什么都是机器码，效率还有差异？

1. 编译器生成的指令数量不同
2. 语言特性强制的额外代码（如边界检查、GC）
3. 运行时库的开销

🔧四、补充元数据

4.1 为什么需要补充元数据

问题：AOT 泛型限制

IL2CPP 在 AOT 编译时，只会为"用到的"泛型组合生成代码：

4.2 补充元数据是什么

4.3 加载补充元数据代码示例

private static readonly string[] AOTAssemblies = new string[]
{
    "mscorlib.dll",
    "System.dll",
    "System.Core.dll",
    "UnityEngine.CoreModule.dll",
    // ... 其他需要的程序集
};

void LoadMetadataForAOTAssemblies()
{
    foreach (var aotDll in AOTAssemblies)
    {
        byte[] dllBytes = LoadDllBytes(aotDll);
        
        LoadImageErrorCode err = RuntimeApi.LoadMetadataForAOTAssembly(
            dllBytes, 
            HomologousImageMode.SuperSet
        );
        
        Debug.Log($"LoadMetadataForAOTAssembly {aotDll}: {err}");
    }
}

4.4 补充元数据的特性

4.5 需要补充哪些程序集

📋五、link.xml 代码保留

5.1 为什么需要 link.xml

Unity IL2CPP 构建时会进行代码裁剪（Stripping），移除"未使用"的代码以减小包体。

但有些代码是动态调用的，编译器检测不到：

// 这些调用方式，编译器检测不到！
Type type = Type.GetType("MyNamespace.MyClass");  // 反射
JsonUtility.FromJson<MyClass>(jsonStr);           // 序列化

5.2 link.xml 的作用

5.3 语法示例

<linker>
    <!-- 保留整个程序集的所有内容 -->
    <assembly fullname="mscorlib" preserve="all"/>
    
    <!-- 保留程序集中的特定类型 -->
    <assembly fullname="UnityEngine.CoreModule">
        <type fullname="UnityEngine.Vector3" preserve="all"/>
        <type fullname="UnityEngine.Quaternion" preserve="all"/>
    </assembly>
    
    <!-- 保留命名空间下的所有类型 -->
    <assembly fullname="Assembly-CSharp">
        <namespace fullname="MyGame.Data" preserve="all"/>
    </assembly>
</linker>

⚖️六、补充元数据 vs link.xml

6.1 本质区别

6.2 图解

🔗七、热更新与 AOT 互调用

7.1 热更新调用 AOT

热更新代码可以直接调用 AOT 代码，就像普通 C# 代码一样：

// 热更新代码中
using UnityEngine;          // Unity API (AOT)
using GameCore;             // 游戏核心框架 (AOT)

namespace HotUpdate
{
    public class HotLogic
    {
        public void Start()
        {
            // ✅ 调用 Unity API（AOT 机器码）
            Debug.Log("Hello from HotUpdate!");
            
            // ✅ 调用游戏核心框架（AOT）
            GameManager.DoSomething();
            
            // ✅ 使用 .NET 类型（AOT）
            var list = new List<string>();
        }
    }
}

7.2 泛型共享机制

引用类型的泛型可以共享机器码：

7.3 注意事项

1. 确保 AOT 类型没被裁剪（link.xml）
2. 泛型方法需要补充元数据
3. 热更新项目需要引用 AOT 程序集才能编译

📁八、程序集引用配置

8.1 命名空间 vs 程序集

8.2 Assembly-CSharp 的特殊性

• Assembly-CSharp 是 Unity 默认生成的主程序集
• 最后编译
• 自动引用所有 asmdef

8.3 热更新程序集配置

// HotUpdate.asmdef
{
    "name": "HotUpdate",
    "references": [
        "GameCore"
    ],
    "autoReferenced": false,
    "includePlatforms": [],
    "excludePlatforms": []
}

↑ autoReferenced: false 禁止被 Assembly-CSharp 自动引用

8.4 推荐项目架构

✨九、最佳实践

9.1 项目结构

9.2 补充元数据策略

// 推荐：启动时加载常用的 AOT 程序集
void LoadMetadata()
{
    // 必须加载
    LoadMetadataForAOTAssembly("mscorlib.dll");
    LoadMetadataForAOTAssembly("System.Core.dll");
    
    // 按需加载
    LoadMetadataForAOTAssembly("UnityEngine.CoreModule.dll");
    LoadMetadataForAOTAssembly("UnityEngine.PhysicsModule.dll");
    LoadMetadataForAOTAssembly("UnityEngine.UI.dll");
}

9.3 link.xml 策略

9.4 性能考虑

❓附录：常见问题

Q1: 热更新代码能调用 AOT 代码吗？

A: 可以，直接引用即可，像普通 C# 代码一样。

Q2: AOT 代码能调用热更新代码吗？

A: 不能直接调用（编译时热更新代码不存在），但可以通过接口/委托/反射间接调用。

Q3: 补充元数据可以热更新吗？

A: 技术上可以，但通常不需要，因为它们随 Unity 版本固定，基本不会变。

Q4: 值类型泛型也能热更吗？

A: 可以，补充元数据提供的 IL 是参数化的，HybridCLR 解释器会在运行时处理任意值类型。

Q5: 解释执行的性能如何？

A: 比 AOT 机器码慢 3-10 倍，但对于业务逻辑通常可以接受。