热更新系列(二)——HybridCLR(huatuo)

关于HybridCLR

[官网](HybridCLR | HybridCLR (code-philosophy.com))

HybridCLR改进了unity的Il2cpp部分,使得其能”解释”执行一些代码,每个unity都可以在安装文件下找到\Data\il2cpp\libil2cpp, HybridCLR就是改进了这一部分.

具体查看:安装HybridCLR | HybridCLR (code-philosophy.com)

原始il2cpp是AOT运行时，不支持动态注册dll元数据。我们轻微改造了metadata管理模块，插入了一些hook代码，支持动态加载dll元数据

安装

依赖模块

安装HybridCLR

Unity Hub 安装相应的IL2cpp模块
Windows
- Win下需要安装visual studio 2019或更高版本。安装时至少要包含 使用Unity的游戏开发 和 使用c++的游戏开发 组件。
- 安装git
Mac
- 要求MacOS版本 >= 12，xcode版本 >= 13，例如xcode 13.4.1， macos 12.4。
- 安装 git
- 安装cmake

目录说明

AssembliesPostIl2CppStrip

打包过程生成的裁剪后的AOT dll. 用于补充元数据,分为不同平台,不同平台不可混用,至于为什么是剪裁后的AOTdll,这是为了减小生成的dll大小也是为了减小内存(下同)
HotUpdateDlls

生成的热更程序集
hybridclr_repo

Hybridclr仓库代码.扩充了il2cpp的代码，使它由纯AOT runtime变成‘AOT+Interpreter’ 混合runtime，进而原生支持动态加载assembly，使得基于il2cpp backend打包的游戏不仅能在Android平台，也能在IOS、Consoles等限制了JIT的平台上高效地以AOT+interpreter混合模式执行，从底层彻底支持了热更新。为解释器部分的核心代码，包含元数据加载、代码transform(编译)、代码解释执行
il2cpp_plus_repo

il2cpp_plus仓库代码,原始的libil2cpp是AOT运行,Hybirdclr改造了metadata管理模块,插入一些hook代码,支持动态加载dll元数据
LocalIl2CppData-WindowsEditor

这里是把Unity自带的MonoBleedingEdge(2019以上)+Il2cpp+改造后的libil2cpp

注:每个平台Editor自带il2cpp不同(windows.linux,macos…),所有要区分

hybridclrinstaller工作原理
StrippedAOTDllsTempProj

生成剪裁后的AOTdll临时工程(意思就是要生成剪裁后的AOTdll得有个工程)

Unity HybridSetting

hybridclr菜单介绍

关于AOTGenericReferences

HybridCLR/generate/AOTGenericReference 命令生成的AOTGenericReferences.cs文件中包含了应该补充元数据的assembly列表.分为三部分

1是需要补充的元数据assembly
2是AOT中用到的泛型类
3是AOT中用到的泛型方法

遇到的一些问题和注意事项

IL2CPP泛型共享代码

il2cpp为了避免泛型代码膨胀，节约内存，在保证代码逻辑正确性的情况下对于一些能够共享代码，只生成一份代码。为此引入一个概念叫泛型代码共享 Generic Sharing。简单来说，你只要在AOT中实例化过某个泛型类或泛型函数的共享实例，你就可以在热更新代码中使用它了。

以List 举例：

可以使用AOT中使用过的任何List的实例化类型。例如你在AOT里用过List,则热更新里也可以用

可以使用任意List。只需要你在AOT里实例化某一个List<相同underlying type的枚举类型>。

可以使用任意引用类型的泛型参数List。只需要你在AOT里实例化过 List