官方文档

实验环境

Unity 版本(国际版): Unity 2020.3.26.f1
hybridclr_unity : https://gitee.com/focus-creative-games/hybridclr_unity.git#v2.0.0-rc

安装HybridCLR (有gitee账号才可使用)

官方安装教程

添加 hybridclr_unity package

• 方法一：
  在 Unity项目/Packages/manifest.json 文件中添加一行（注意逗号, 末尾行不需要在后面加逗号）
  “com.focus-creative-games.hybridclr_unity”: “https://gitee.com/focus-creative-games/hybridclr_unity.git#v2.0.0-rc”,
  如:

{"dependencies": {"com.focus-creative-games.hybridclr_unity": "https://gitee.com/focus-creative-games/hybridclr_unity.git#v2.0.0-rc","com.unity.2d.sprite": "1.0.0","com.unity.2d.tilemap": "1.0.0","com.unity.ide.rider": "3.0.7","com.unity.ide.visualstudio": "2.0.12","com.unity.render-pipelines.universal": "10.8.1","com.unity.textmeshpro": "3.0.6","com.unity.timeline": "1.6.2","com.unity.ugui": "1.0.0","com.unity.modules.ai": "1.0.0","com.unity.modules.androidjni": "1.0.0","com.unity.modules.animation": "1.0.0","com.unity.modules.assetbundle": "1.0.0","com.unity.modules.audio": "1.0.0","com.unity.modules.cloth": "1.0.0","com.unity.modules.director": "1.0.0","com.unity.modules.imageconversion": "1.0.0","com.unity.modules.imgui": "1.0.0","com.unity.modules.particlesystem": "1.0.0","com.unity.modules.physics": "1.0.0","com.unity.modules.physics2d": "1.0.0","com.unity.modules.screencapture": "1.0.0","com.unity.modules.terrain": "1.0.0","com.unity.modules.terrainphysics": "1.0.0","com.unity.modules.tilemap": "1.0.0","com.unity.modules.ui": "1.0.0","com.unity.modules.uielements": "1.0.0","com.unity.modules.umbra": "1.0.0","com.unity.modules.unityanalytics": "1.0.0","com.unity.modules.unitywebrequest": "1.0.0","com.unity.modules.unitywebrequestassetbundle": "1.0.0","com.unity.modules.unitywebrequestaudio": "1.0.0","com.unity.modules.unitywebrequesttexture": "1.0.0","com.unity.modules.unitywebrequestwww": "1.0.0","com.unity.modules.vehicles": "1.0.0","com.unity.modules.video": "1.0.0","com.unity.modules.wind": "1.0.0"}
}

• 方法二：
  使用 git 拉取 https://gitee.com/focus-creative-games/hybridclr_unity.git 项目到本地
  创建文件夹 com.focus-creative-games.hybridclr_unity
  把拉取下来的文件拷贝到 com.focus-creative-games.hybridclr_unity 文件夹(不要拷贝 .git 文件夹)
  把 com.focus-creative-games.hybridclr_unity 文件夹 拷贝到 Unity项目/Packages/ 文件夹下

安装

运行 HybridCLR/Installer… 再点击安装 (有的版本比较特殊)

HybridCLR Unity项目设置

Build Setting 设置

1. 使用 Faster runtime。(有的平台有，有的平台无此选项)

Player 设置

1. Scripting Backend 必须是 IL2CPP
2. Api Compatibility Level* 没特殊情况 设置为 .Net 4.x
3. Use incremental GC 取消勾选，暂时不支持增量GC

HybridCLR Settings

1. 热更新 dll（Hot Update Assemblies) 与 热更新 Assembly Definitions(Hot Update Assembly Definitions)
   不能把同一个dll 名字配置到 两个配置中。 两个都表示可以热更新的 dll 名称（不带扩展名）
   Hot Update Assembiles 表示普通dll
   Hot Update Assembly Definitions 表示Unity项目中的(assembly definition)程序集
2. externalHotUpdateAssemblyDirs 外部热更新dll搜索路径
   如果热更新 dll 项目 是Unity外部的，则需要配置一个外部dll所在的路径。

泛型

1.HybridCLR的补充元数据技术。如果热更新 dll 中使用到 aot dll 中的泛型类，那么这个aot dll 就需要调用RuntimeApi.LoadMetadataForAOTAssembly 方法来补充元数据。
补充元数据有两个模式
HomologousImageMode.Consistent 只能使用裁减后的AOT dll
HomologousImageMode.SuperSet 既可以使用裁减后的AOT dll 也可以使用原始 AOT dll
补充元数据的泛型函数以解释方式运行，执行效率慢，最好提前在AOT中泛型实例化(HybridCLR/Generate/AOTGenericReference)工具可以自动收集泛型实例
2.il2cpp 的泛型共享技术 （值类型无法使用，最好还是使用（第一种方法+AOT中编写一个泛型实例化））
详细介绍

我的理解

1. AOT 表示表示静态编译。上下文中的 AOT dll 表示静态编译的 dll(可以理解为除了热更新dll，其他的就是 AOT dll)。静态编译一般是不能被更新的，HybridCLR 中也可以被热更新(具体看官网，除非万不得已不然我不会热更新这个)
2. 热更新 可以 依赖 热更新dll 以及 AOT dll， 但是 AOT 不可以依赖 热更新 dll。所以热更新dll一般采用 Assembly-CSharp 或者 外部 dll作为热更新 dll。
3. 热更新多个 dll 时，需要先加载被依赖的 dll

未完待续。。。