Unity C#热更新框架ILRuntime接入

简介

ILRuntime项目为基于C#的平台（例如Unity）提供了一个纯C#实现，快速、方便且可靠的IL运行时，使得能够在不支持JIT的硬件环境（如iOS）能够实现代码的热更新

官方教程

https://ourpalm.github.io/ILRuntime/public/v1/guide/tutorial.html

安装

Window->packageManager->搜索ILRuntime，可以安装对应组件

之后可以再packageManager页面导入ILRuntime的demo

相关demo的git地址为https://github.com/Ourpalm/ILRuntimeU3D

ILRuntimeDemo解析

这里以示例工程为例，跑一遍ILRuntime的热更流程

1.生成可热更的DLL文件

可热更工程HotFix所在目录为

Assets\Samples\ILRuntime\2.1.0\Demo\HotFix_Project~

用vs打开HotFix_Project.sln

选择HotFix_Project右键生成

生成成功之后会将对应的HotFix_Project.dll文件输出到StreamingAssets目录下

2.打开场景

所有demo场景的目录为ILRuntime/2.1.0/Demo/_Scenes/Examples

这里选择打开第一个demo场景01_HelloWorld

3.加载DLL文件

demo场景里面包含了一个HelloWorld的类，其中LoadHotFixAssembly逻辑主要是创建ILRuntime程序域，之后从StreamingAssets文件夹读取DLL文件，并且加载对应的程序及

IEnumerator LoadHotFixAssembly()
    {
        //首先实例化ILRuntime的AppDomain，AppDomain是一个应用程序域，每个AppDomain都是一个独立的沙盒
        appdomain = new ILRuntime.Runtime.Enviorment.AppDomain();
        //正常项目中应该是自行从其他地方下载dll，或者打包在AssetBundle中读取，平时开发以及为了演示方便直接从StreammingAssets中读取，
        //正式发布的时候需要大家自行从其他地方读取dll

        //!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
        //这个DLL文件是直接编译HotFix_Project.sln生成的，已经在项目中设置好输出目录为StreamingAssets，在VS里直接编译即可生成到对应目录，无需手动拷贝
        //工程目录在Assets\Samples\ILRuntime\1.6\Demo\HotFix_Project~
        //以下加载写法只为演示，并没有处理在编辑器切换到Android平台的读取，需要自行修改
#if UNITY_ANDROID
        WWW www = new WWW(Application.streamingAssetsPath + "/HotFix_Project.dll");
#else
        WWW www = new WWW("file:///" + Application.streamingAssetsPath + "/HotFix_Project.dll");
#endif
        while (!www.isDone)
            yield return null;
        if (!string.IsNullOrEmpty(www.error))
            UnityEngine.Debug.LogError(www.error);
        byte[] dll = www.bytes;
        www.Dispose();

        //PDB文件是调试数据库，如需要在日志中显示报错的行号，则必须提供PDB文件，不过由于会额外耗用内存，正式发布时请将PDB去掉，下面LoadAssembly的时候pdb传null即可
#if UNITY_ANDROID
        www = new WWW(Application.streamingAssetsPath + "/HotFix_Project.pdb");
#else
        www = new WWW("file:///" + Application.streamingAssetsPath + "/HotFix_Project.pdb");
#endif
        while (!www.isDone)
            yield return null;
        if (!string.IsNullOrEmpty(www.error))
            UnityEngine.Debug.LogError(www.error);
        byte[] pdb = www.bytes;
        fs = new MemoryStream(dll);
        p = new MemoryStream(pdb);
        try
        {
            appdomain.LoadAssembly(fs, p, new ILRuntime.Mono.Cecil.Pdb.PdbReaderProvider());
        }
        catch
        {
            Debug.LogError("加载热更DLL失败，请确保已经通过VS打开Assets/Samples/ILRuntime/1.6/Demo/HotFix_Project/HotFix_Project.sln编译过热更DLL");
        }

        InitializeILRuntime();
        OnHotFixLoaded();
    }

加载程序集完成之后调用OnHotFixLoaded，就是调用了热更工程中的HotFix_Project.InstanceClass类的StaticFunTest方法

 void OnHotFixLoaded()
{
        //HelloWorld，第一次方法调用
        appdomain.Invoke("HotFix_Project.InstanceClass", "StaticFunTest", null, null);

}

打开HotFix工程中的InstanceClass.cs，可以看到对应的实现就是一个静态函数，简单地输出日志

 public static void StaticFunTest()
 {
     UnityEngine.Debug.Log("!!! InstanceClass.StaticFunTest()");
}

运行该场景，可以看到最终运行结果。