ILRuntime热更新

2022-09-21 11:19:06 浏览数 (1)

  • 项目/教程地址:传送门

  • IL热更优点: 1、无缝访问C#工程的现成代码,无需额外抽象脚本API 2、直接使用VS2015进行开发,ILRuntime的解译引擎支持.Net 4.6编译的DLL 3、执行效率是L#的10-20倍| 4、选择性的CLR绑定使跨域调用更快速,绑定后跨域调用的性能能达到slua的2倍左右(从脚本调用GameObject之类的接口) 5、支持跨域继承 6、完整的泛型支持 7、拥有Visual Studio的调试插件,可以实现真机源码级调试。支持Visual Studio 2015 Update3 以及Visual Studio 2017和Visual Studio 2019 8、最新的2.0版引入的寄存器模式将数学运算性能进行了大幅优化
  • 工程使用U3D核心模板,版本号:2020.3.27f1(Personal)
  • ILRuntime版本:2.1.0-preview
  • 2020/7/29补充:ILRuntime框架允许直接使用Unity的组件,具体可以直接在B站直接搜索ILRuntime,找到视频时长为2小时左右的那个教程(B站基本上都是那一个教程),那个教程有详细框架搭建和指引,算是目前免费的里面比较好的教程视频了。在ILRuntime热更框架中你可以直接使用Unity组件,直接用Find等方式找到GameObject然后编写代码逻辑。付费课程我看Siki学院有个全套的,但太贵了我就没买(<-暗示)

我建议ILRuntime的官方手册作者罚抄《CLR via C#》100遍,看看人家怎么写教程的。

目录

  • 前置知识
  • 手册部分
    • 环境
    • 基础
      • 原理
      • 优势
      • C# vs Lua
    • 教程
      • 从零开始
      • 安装调试器
      • 寄存器模式
      • 跨域继承
      • 反射
      • CLR重定向
      • CLR绑定
      • LitJson集成
      • 额外补充
    • 其他
      • ILRuntime的性能优化
  • Examples部分
    • 01.HelloWorld
    • 02.Invocation(调用)
    • 03.Delegate(跨域委托)
    • 04.Inheritance(跨域继承)
    • 05.CLRRedirection(CLR重定向)
    • 06.CLRBinding(CLR绑定)
    • 07.Coroutine(协程调用)
    • 08.MonoBehaviour(热更DLL使用MonoBehaviour->不建议)
    • 09.Reflection(主工程反射DLL类型)
    • 10.LitJson(LitJson支持)
    • 11.ValueTypeBinding(值类型绑定)
    • 12.Performance(真机ILRuntime与Lua对比)

前置知识

  • CLR:Common Language Runtime,可由多重编程语言使用的“运行时(即Runtime)”。
  • lib,dll,pdb文件:传送门。dll动态链接库,pdb程序数据二进制文件,pdb文件保存着调试和项
  • 目状态信息,主要作用是调试。
  • ref、out:传送门
  • GC(generational garbage collector):基于代的垃圾回收器
  • appdomain:CLR COM服务器初始化时会创建一个AppDomain。AppDomain是一组程序集的逻
  • 辑容器。CLR初始化时创建的第一个AppDomain称为“默认AppDomain”,这个默认的AppDomain
  • 只有在Windows进程终止时才会被销毁。除了默认 AppDomain,正在使用非托管COM接口方法
  • 或托管类型方法的宿主还可要求CLR创建额外的 AppDomain。AppDomain是为了提供隔离而设计
  • 的。
  • 反射:编译时对一个类型一无所知的情况下,如何在运行时发现类型的信息、创建类型的实例以及
  • 访问类型的成员。反射造成编译时无法保证类型安全性。同时反射有较大的开销。What’s GC.Alloc?
  • GC.Alloc means that during the run time your code (or something in the API) allocates this
  • much of the managed memory.
  • This can cause problems later (that’s why it has the row in the profiler), because when the
  • Garbage Collector runs, it tends to slow down or even hang your game.
  • ILRuntime原理图表

手册部分

环境

  • Windows10
  • Unity:2020.3.27f1(Personal)
  • ILRuntime版本:2.1.0-preview
  • IDE:Visual Studio 2022
  • JDK:Java SE 8(8u202 and earlier)
  • SDK Tools:24.4.1
  • 模拟器:雷电模拟器9.0.5

基础

原理

  • ILRuntime借助Mono.Cecil库来读取DLL的PE信息,以及当中类型的所有信息,最终得到方法的IL汇编码,然后通过内置的IL解译执行虚拟机来执行DLL中的代码。 ILRuntime目标是读取热更新的dll,编译成IL,然后使用自己的JIT Compiler来执行热更dll中的代码,达到热更的目的。
  • ILRuntime自己实现了一些类型和栈的操作,以此减少装箱拆箱的次数。

优势

  • 无缝访问C#工程的现成代码,无需额外抽象脚本API
  • 直接使用VS2015进行开发,ILRuntime的解译引擎支持.Net 4.6编译的DLL
  • 执行效率是L#的10-20倍
  • 选择性的CLR绑定使跨域调用更快速,绑定后跨域调用的性能能达到slua的2倍左右(从脚本调用GameObject之类的接口)
  • 支持跨域继承
  • 完整的泛型支持
  • 拥有Visual Studio的调试插件,可以实现真机源码级调试。支持Visual Studio 2015 Update3 以及Visual Studio 2017和Visual Studio 2019
  • 最新的2.0版引入的寄存器模式将数学运算性能进行了大幅优化

C# vs Lua

  • 用Lua热更需要对Lua和C#都比较熟悉,Lua优势在于足够成熟。
  • C#直接使用更加便捷

教程

从零开始

  • 在Packages/manifest.json中,添加ILRuntime的源信息:
代码语言:javascript复制
"scopedRegistries": [
  {
    "name": "ILRuntime",
    "url": "https://registry.npmjs.org",
    "scopes": [
      "com.ourpalm"
    ]
  }
],
  • Unity编辑器弹出:
  • Window->Package Manager菜单中找到ILRuntime如下图所示,然后点击右下角安装
  • 点击如下两个位置导入sample
  • 报错:Unsafe code may only appear if compiling with /unsafe. Enable “Allow ‘unsafe’ code” in Player Settings to fix this error.
  • 解决方法:允许编译Unsafe code。在build settings里选player settings选palyer里面有一项Allow Unsafe Code改为选中状态。
  • 找到下图文件夹并打开导入sln,并进行release编译。(ILRuntime加载的dll文件是Release模式编译的)
  • 报错:必须添加对程序集“netstandard, Version=2.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51”的引用
  • 解决方案:我的默认工程文件框架为4.6.0,更改到更高的版本再进行编译即可生成dll
  • 顺利生成dll文件

安装调试器

  • 报错:安装无法将此扩展安装到所有选定的产品
  • 尝试解决问题-未允许扩展开发:打开log日志,其中有一个log状态“找到安装程序实例 4e5d7448,但其处于不可启用状态。”,可能原因为在visual stdio中并未安装扩展开发组件,需要在installer中安装。
  • 安装完成后仍报错,解决方案2,直接查看vsix中的签署文件extension.vsixmanifest。发现安装版本前置条件设置为12.0版本,故直接更改到我目前的vs大版本17.0。
  • 再次点击,顺利完成安装。

寄存器模式

(对应Examples 03)

  • 委托适配器(DelegateAdapter):将委托实例传出给ILRuntime外部使用,将其转换成CLR委托实例。
  • 由于IL2CPP之类的AOT编译技术无法在运行时生成新的类型,所以在创建委托实例的时候ILRuntime选择了显式注册的方式,以保证问题不被隐藏到上线后才发现。
代码语言:javascript复制
//同一参数组合只需要注册一次
delegate void SomeDelegate(int a, float b);
Action<int, float> act;
//注册,不带返回值,最多支持五个参数传入
appDomain.DelegateManager.RegisterMethodDelegate<int, float>();

//注册,带参数返回值,最后一个参数为返回值,最多支持四个参数传入
delegate bool SomeFunction(int a, float b);
Func<int, float, bool> act;
  • 委托转换器:需要将一个不是Action或者Func类型的委托实例传到ILRuntime外部使用,需要写委托适配器和委托转换器。委托转换器将Action和Func转换成你真正需要的那个委托类型
代码语言:javascript复制
app.DelegateManager.RegisterDelegateConvertor<SomeFunction>((action) =>
{
    return new SomeFunction((a, b) =>
    {
       return ((Func<int, float, bool>)action)(a, b);
    });
});
  • 为了避免不必要的麻烦,以及后期热更出现问题,建议: 1、尽量避免不必要的跨域委托调用 2、尽量使用Action以及Func委托类型

跨域继承

  • 建议直接看demo中的Inheritance部分。手册中的adpter可以在Unity中自动生成。

反射

  • 反射有损性能,建议不用。大部分教程都推荐使用CLR绑定。

CLR重定向

  • ILRuntime为了解决外部调用内部接口的问题,引入了CLR重定向机制。 原理就是当IL解译器发现需要调用某个指定CLR方法时,将实际调用重定向到另外一个方法进行挟持,再在这个方法中对ILRuntime的反射的用法进行处理
  • 从代码中可以看出重定向的工作是把方法挟持下来后装到ILIntepreter的解释器里面实例化
  • 不带返回值的重定向:
代码语言:javascript复制
public static StackObject* CreateInstance(ILIntepreter intp, StackObject* esp, List<object> mStack, CLRMethod method, bool isNewObj)
{
    //获取泛型参数<T>的实际类型
    IType[] genericArguments = method.GenericArguments;
    if (genericArguments != null && genericArguments.Length == 1)
    {
        var t = genericArguments[0];
        if (t is ILType)//如果T是热更DLL里的类型
        {
            //通过ILRuntime的接口来创建实例
            return ILIntepreter.PushObject(esp, mStack, ((ILType)t).Instantiate());
        }
        else
            return ILIntepreter.PushObject(esp, mStack, Activator.CreateInstance(t.TypeForCLR));//通过系统反射接口创建实例
    }
    else
        throw new EntryPointNotFoundException();
}
//注册
foreach (var i in typeof(System.Activator).GetMethods())
{
    //找到名字为CreateInstance,并且是泛型方法的方法定义
    if (i.Name == "CreateInstance" && i.IsGenericMethodDefinition)
    {
        //RegisterCLRMethodRedirection:通过redirectMap存储键值对MethodBase-CLRRedirectionDelegate,如果i不为空且redirectMap中没有传入的MethodBase(即下方的i)则存储redirectMap[i] = CreateInstance。所以如此看来注册行为就是把键值对存储到redirectMap的过程
        appdomain.RegisterCLRMethodRedirection(i, CreateInstance);
    }
}
  • 带返回值方法的重定向
代码语言:javascript复制
public unsafe static StackObject* DLog(ILIntepreter __intp, StackObject* __esp, List<object> __mStack, CLRMethod __method, bool isNewObj)
{
    ILRuntime.Runtime.Enviorment.AppDomain __domain = __intp.AppDomain;
    StackObject* ptr_of_this_method;
    //只有一个参数,所以返回指针就是当前栈指针ESP - 1
    StackObject* __ret = ILIntepreter.Minus(__esp, 1);
    //第一个参数为ESP -1, 第二个参数为ESP - 2,以此类推
    ptr_of_this_method = ILIntepreter.Minus(__esp, 1);
    //获取参数message的值
    object message = StackObject.ToObject(ptr_of_this_method, __domain, __mStack);
    //需要清理堆栈
    __intp.Free(ptr_of_this_method);
    //如果参数类型是基础类型,例如int,可以直接通过int param = ptr_of_this_method->Value获取值,
    //关于具体原理和其他基础类型如何获取,请参考ILRuntime实现原理的文档。
			
    //通过ILRuntime的Debug接口获取调用热更DLL的堆栈
    string stackTrace = __domain.DebugService.GetStackTrance(__intp);
    Debug.Log(string.Format("{0}n{1}", format, stackTrace));

    return __ret;
}

CLR绑定

  • 通过反射来调用接口调用效率会比直接调用低很多,再加上反射传递函数参数时需要使用object[]数组,这样不可避免的每次调用都会产生不少GC Alloc。众所周知GC Alloc高意味着在Unity中执行会存在较大的性能问题。
  • 最新版本有自动CLR绑定生成

LitJson集成

  • Json序列化是开发中非常经常需要用到的功能,考虑到其通用性,因此ILRuntime对LitJson这个序列化库进行了集成
代码语言:javascript复制
//对LitJson进行注册,需要在注册CLR绑定之前
LitJson.JsonMapper.RegisterILRuntimeCLRRedirection(appdomain);
//LitJson使用
//将一个对象转换成json字符串
string json = JsonMapper.ToJson(obj);
//json字符串反序列化成对象
JsonTestClass obj = JsonMapper.ToObject<JsonTestClass>(json);

额外补充

  • 原教程代码示例中:Mono.Cecil.Pdb.PdbReaderProvider(),应改为ILRuntime.Mono.Cecil.Pdb.PdbReaderProvider()

其他

ILRuntime的性能优化

  • 博客中提到的性能优化建议:
  • 值类型优化:使用ILRuntime外部定义的值类型(例如UnityEngine.Vector3)在默认情况下会造成额外的装箱拆箱开销。ILRuntime在1.3.0版中增加了值类型绑定(ValueTypeBinding)机制,通过对这些值类型添加绑定器,可以大幅增加值类型的执行效率,以及避免GC Alloc内存分配。
  • 大规模数值计算:如果在热更内需要进行大规模数值计算,则可以开启ILRuntime在2.0版中加入的寄存器模式来进行优化
  • 避免使用foreach:尽量避免使用foreach,会不可避免地产生GC。而for循环不会。

Examples部分

01.HelloWorld

  • 加载dll并在逻辑后处理进行简单调用
  • 整个文件流程:创建IEnumerator并运行->用文件流判断并读入dll和pdb->尝试加载程序集dll->(如果加载成功)初始化脚本引擎(InitializeILRuntime())->执行脚本引擎加载后的逻辑处理(OnHotFixLoaded())->程序销毁(在OnDestoy中关闭dll和pdb的文件流)
  • MemoryStream:为系统提供流式读写。MemoryStream类封装一个字节数组,在构造实例时可以使用一个字节数组作为参数,但是数组的长度无法调整。使用默认无参数构造函数创建实例,可以使用Write方法写入,随着字节数据的写入,数组的大小自动调整。 参考博客:传送门
  • appdomain.LoadAssembly:将需要热更的dll加载到解释器中。第一个填入dll以及pdb,这里的pdb应该是dll对应的一些标志符号。 后面的ILRuntime.Mono.Cecil.Pdb.PdbReaderProvider()是动态修改程序集,它的作用是给ILRuntime.Mono.Cecil.Pdb.PdbReaderProvider()里的GetSymbolReader)(传入两个参数,一个是通过转化后的ModuleDefinition.ReadModule(stream(即dll))模块定义,以及原来的symbol(即pdb) GetSymbolReader主要的作用是检测其中的一些符号和标志是否为空,不为空的话就进行读取操作。 (这些内容都是ILRuntime中的文件来完成)
代码语言:javascript复制
//appdomain.LoadAssembly,他还有一个重载版本,只填入第一个steam,其余会自动补充为null
//第三个空填入new ILRuntime.Mono.Cecil.Pdb.PdbReaderProvider()
public void LoadAssembly(Stream stream, Stream symbol, ISymbolReaderProvider symbolReader)
//ILRuntime.Mono.Cecil.Pdb.PdbReaderProvider()
public ISymbolReader GetSymbolReader(ModuleDefinition module, string fileName);
public ISymbolReader GetSymbolReader(ModuleDefinition module, Stream symbolStream)
  • appdomain.Invoke:可以明显看出第三个参数传入与否没用任何用处,只有在返回时原封不动地重新传入了instance
代码语言:javascript复制
public object Invoke(string type, string method, object instance, params object[] p)
//方法实现
public object Invoke(string type, string method, object instance, params object[] p)
{
            IType type2 = GetType(type);
            if (type2 == null)
            {
                return null;
            }

            IMethod method2 = type2.GetMethod(method, (p != null) ? p.Length : 0);
            if (method2 != null)
            {
                for (int i = 0; i < method2.ParameterCount; i  )
                {
                    if (p[i] != null && !method2.Parameters[i].TypeForCLR.IsAssignableFrom(p[i].GetType()))
                    {
                        throw new ArgumentException("Parameter type mismatch");
                    }
                }

                return Invoke(method2, instance, p);
            }

            return null;
}
//普通调用
appdomain.Invoke("HotFix_Project.InstanceClass", "StaticFunTest", null, null);
//HotFix_Project.InstanceClass里的静态方法StaticFunTest
public static void StaticFunTest()
{
	UnityEngine.Debug.Log("!!! InstanceClass.StaticFunTest()");
}
//传参调用
appdomain.Invoke("HotFix_Project.InstanceClass", "StaticFunTest2", null, 123);
//HotFix_Project.InstanceClass里的静态方法HotFix_Project.InstanceClass
public static void StaticFunTest2(int a)
{
	UnityEngine.Debug.Log("!!! InstanceClass.StaticFunTest2(), a="   a);
}
//泛型调用
public static void GenericMethod<T>(T a)
{
	UnityEngine.Debug.Log("!!! InstanceClass.GenericMethod(), a="   a);
}
//多值调用ref/out
public void RefOutMethod(int addition, out List<int> lst, ref int val)
{
	val = val   addition   id;
	lst = new List<int>();
	lst.Add(id);
}
  • 剩余事项都在示例代码注释中有所提及。

02.Invocation(调用)

  • 对逻辑后处理部分进行了各种方式的调用展示(详细内容请看01)
  • 优化:预先获得IMethod,可以减低每次调用查找方法耗用的时间
代码语言:javascript复制
Debug.Log("通过IMethod调用方法");
//预先获得IMethod,可以减低每次调用查找方法耗用的时间
IType type = appdomain.LoadedTypes["HotFix_Project.InstanceClass"];
//根据方法名称和参数个数获取方法
IMethod method = type.GetMethod("StaticFunTest2", 1);
appdomain.Invoke(method, null, 123);

03.Delegate(跨域委托)

  • 委托的使用以及热更新注册部分
  • 实现:定义->InitializeILRuntime()添加适配器/转换器->OnHotFixLoaded()调用
代码语言:javascript复制
void InitializeILRuntime()
{
#if DEBUG && (UNITY_EDITOR || UNITY_ANDROID || UNITY_IPHONE)
        //由于Unity的Profiler接口只允许在主线程使用,为了避免出异常,需要告诉ILRuntime主线程的线程ID才能正确将函数运行耗时报告给Profiler
        appdomain.UnityMainThreadID = System.Threading.Thread.CurrentThread.ManagedThreadId;
#endif
        //这里做一些ILRuntime的注册
        //TestDelegateMethod, 这个委托类型为有个参数为int的方法,注册仅需要注册不同的参数搭配即可
        appdomain.DelegateManager.RegisterMethodDelegate<int>();
        //带返回值的委托的话需要用RegisterFunctionDelegate,返回类型为最后一个
        appdomain.DelegateManager.RegisterFunctionDelegate<int, string>();
        //Action<string> 的参数为一个string
        appdomain.DelegateManager.RegisterMethodDelegate<string>();
        
        //ILRuntime内部是用Action和Func这两个系统内置的委托类型来创建实例的,所以其他的委托类型都需要写转换器
        //将Action或者Func转换成目标委托类型

        appdomain.DelegateManager.RegisterDelegateConvertor<TestDelegateMethod>((action) =>
        {
            //转换器的目的是把Action或者Func转换成正确的类型,这里则是把Action<int>转换成TestDelegateMethod
            return new TestDelegateMethod((a) =>
            {
                //调用委托实例
                ((System.Action<int>)action)(a);
            });
        });
        //对于TestDelegateFunction同理,只是是将Func<int, string>转换成TestDelegateFunction
        appdomain.DelegateManager.RegisterDelegateConvertor<TestDelegateFunction>((action) =>
        {
            return new TestDelegateFunction((a) =>
            {
                return ((System.Func<int, string>)action)(a);
            });
        });

        //下面再举一个这个Demo中没有用到,但是UGUI经常遇到的一个委托,例如UnityAction<float>
        appdomain.DelegateManager.RegisterDelegateConvertor<UnityEngine.Events.UnityAction<float>>((action) =>
        {
            return new UnityEngine.Events.UnityAction<float>((a) =>
            {
                ((System.Action<float>)action)(a);
            });
        });
}
代码语言:javascript复制
//补充
//从源码中可以看到以下两种注册都是使用Action和Func进行实现的,整合后会转递给:public void RegisterDelegateConvertor<T>(Func<Delegate, Delegate> action)
//RegisterMethodDelegate最多支持五个泛型
public void RegisterMethodDelegate<T1, T2, T3, T4, T5>()
//RegisterFunctionDelegate最多支持五个泛型,最后一个是返回值
public void RegisterFunctionDelegate<TResult>()
public void RegisterFunctionDelegate<T1, T2, T3, T4, TResult>()
  • 如果需要跨域调用委托(将热更DLL里面的委托实例传到Unity主工程用), 就需要注册适配器
  • 应该尽量减少不必要的跨域委托调用,如果委托只在热更DLL中用,是不需要进行任何注册的

04.Inheritance(跨域继承)

  • 创建热更类->注册适配器->创建实例
代码语言:javascript复制
//热更类
public abstract class TestClassBase
{
    public virtual int Value
    {
        get
        {
            return 0;
        }
        set
        {

        }
    }

    public virtual void TestVirtual(string str)
    {
        Debug.Log("!! TestClassBase.TestVirtual, str = "   str);
    }

    public abstract void TestAbstract(int gg);
}
//加载后处理
void OnHotFixLoaded()
{
        Debug.Log("首先我们来创建热更里的类实例");
        TestClassBase obj;
        Debug.Log("现在我们来注册适配器, 该适配器由ILRuntime/Generate Cross Binding Adapter菜单命令自动生成");
        appdomain.RegisterCrossBindingAdaptor(new TestClassBaseAdapter());
        Debug.Log("现在再来尝试创建一个实例");
    //这里的TestInheritance为public class TestInheritance : TestClassBase
    //appdomain.Instantiate:public T Instantiate<T>(string type, object[] args = null)
        obj = appdomain.Instantiate<TestClassBase>("HotFix_Project.TestInheritance");
        Debug.Log("现在来调用成员方法");
        obj.TestAbstract(123);
        obj.TestVirtual("Hellopublic T Instantiate<T>(string type, object[] args = null)
        obj.Value = 233;//public override int Value { get; set; }
        Debug.LogFormat("obj.Value={0}", obj.Value);


        Debug.Log("现在换个方式创建实例");
        obj = appdomain.Invoke("HotFix_Project.TestInheritance", "NewObject", null, null) as TestClassBase;
        obj.TestAbstract(456);
        obj.TestVirtual("Foobar");
        obj.Value = 2333333;
        Debug.LogFormat("obj.Value={0}", obj.Value);
}

05.CLRRedirection(CLR重定向)

  • CLR重定向:需要挟持原方法实现,添加一些热更DLL中的特殊处理的时使用。
  • 由以下代码可以看到,如果不使用重定向,那么系统会调用反射方法来检测使用log。即可以大致的理解为重定向可以允许跨域的调用使用方法。而当没有重定向时,需要使用反射,去“探索”要调用的方式方法。
代码语言:javascript复制
unsafe void InitializeILRuntime()
{
	...
	//这里做一些ILRuntime的注册
	var mi = typeof(Debug).GetMethod("Log", new System.Type[] { typeof(object) });
    //Log_11为重定向方法
    appdomain.RegisterCLRMethodRedirection(mi, Log_11);
}
unsafe void OnHotFixLoaded()
{
	Debug.Log("请注释和解除InitializeILRuntime方法里的重定向注册,对比下一行日志的变化");
    //注册时显示:call System.Void UnityEngine.Debug::Log(System.Object)
    /*注释时显示:System.Reflection.MethodBase:Invoke (object,object[])
    ILRuntime.CLR.Method.CLRMethod:Invoke*/
    appdomain.Invoke("HotFix_Project.TestCLRRedirection", "RunTest", null, null);
}

06.CLRBinding(CLR绑定)

  • (首先在菜单栏中点击自动生成绑定文件)
  • 按照提示对比方法执行耗时:ILRuntime.Runtime.Generated.CLRBindings.Initialize(appdomain); 注释时:950ms 解除注释:150ms 基础注释并使用RunTest():170ms
  • 可以明显看出CLR绑定对于方法执行耗时有显著的改善,同时先确定IMethod在Invoke会省去一定的查找时间,但对于性能的影响相对较小。
  • 注释时和解除注释时产生的GC.Alloc
代码语言:javascript复制
//CLR绑定,放在void InitializeILRuntime()里的末尾部分
ILRuntime.Runtime.Generated.CLRBindings.Initialize(appdomain);

void Update()
{
        if (ilruntimeReady && !executed && Time.realtimeSinceStartup > 3)
        {
            executed = true;
            //这里为了方便看Profiler,代码挪到Update中了
            System.Diagnostics.Stopwatch sw = new System.Diagnostics.Stopwatch();
            var type = appdomain.LoadedTypes["HotFix_Project.TestCLRBinding"];
            var m = type.GetMethod("RunTest", 0);
            Debug.Log("请解除InitializeILRuntime方法中的注释对比有无CLR绑定对运行耗时和GC开销的影响");
            sw.Reset();
            sw.Start();
            //使用直接调用的方法
            Profiler.BeginSample("RunTest");
            appdomain.Invoke("HotFix_Project.TestCLRBinding", "RunTest", null, null);
            /*使用指定位置后调用的方法
            Profiler.BeginSample("RunTest2");
            appdomain.Invoke(m, null, null);*/
            Profiler.EndSample();
            sw.Stop();
            Debug.LogFormat("刚刚的方法执行了:{0} ms", sw.ElapsedMilliseconds);

            Debug.Log("可以看到运行时间和GC Alloc有大量的差别,RunTest2之所以有20字节的GC Alloc是因为Editor模式ILRuntime会有调试支持,正式发布(关闭Development Build)时这20字节也会随之消失");
        }
}

07.Coroutine(协程调用)

  • 在主工程文件中写方法调用协程,之后使用协程直接传递。
  • 跨域继承只能有1个Adapter,因此应该尽量避免一个类同时实现多个外部接口,对于coroutine来说是IEnumerator<object>,IEnumerator和IDisposable,ILRuntime虽然支持,但是一定要小心这种用法,使用不当很容易造成不可预期的问题。
  • 日常开发如果需要实现多个DLL外部接口,请在Unity这边先做一个基类实现那些个接口,然后继承那个基类
代码语言:javascript复制
void InitializeILRuntime()
{
	...
	//使用Couroutine时,C#编译器会自动生成一个实现了IEnumerator,IEnumerator<object>,IDisposable接口的类,因为这是跨域继承,所以需要写CrossBindAdapter(详细请看04_Inheritance教程),Demo已经直接写好,直接注册即可
    appdomain.RegisterCrossBindingAdaptor(new CoroutineAdapter());
    appdomain.DebugService.StartDebugService(56000);//如果要执行单步debug就加上这句话
}

//Demo协程
public class CoroutineDemo : MonoBehaviour
{
    static CoroutineDemo instance;
    public static CoroutineDemo Instance
    {
        get {return instance;}
    }
}
//HotFix_Project->TestCoroutine代码
public class TestCoroutine
{
	public static void RunTest()
    {
		CoroutineDemo.Instance.DoCoroutine(Coroutine());
    }

	static System.Collections.IEnumerator Coroutine()
    {
		Debug.Log("开始协程,t="   Time.time);
         yield return new WaitForSeconds(3);
         Debug.Log("等待了3秒,t="   Time.time);
    }
}

08.MonoBehaviour(热更DLL使用MonoBehaviour->不建议)

09.Reflection(主工程反射DLL类型)

  • 热更DLL中使用反射跟原生C#没有区别
  • Demo主要介绍主工程反射热更DLL中的类型
代码语言:javascript复制
void OnHotFixLoaded()
{
        Debug.Log("热更DLL中的类型我们均需要通过AppDomain取得");
        var it = appdomain.LoadedTypes["HotFix_Project.InstanceClass"];
        Debug.Log("LoadedTypes返回的是IType类型,但是我们需要获得对应的System.Type才能继续使用反射接口");
        var type = it.ReflectionType;
        Debug.Log("取得Type之后就可以按照我们熟悉的方式来反射调用了");
    //返回为当前 Type 定义的所有公共构造函数。
        var ctor = type.GetConstructor(new System.Type[0]);
        var obj = ctor.Invoke(null);
        Debug.Log("打印一下结果");
        Debug.Log(obj);
        Debug.Log("我们试一下用反射给字段赋值");
        var fi = type.GetField("id", System.Reflection.BindingFlags.NonPublic | System.Reflection.BindingFlags.Instance);
        fi.SetValue(obj, 111111);
        Debug.Log("我们用反射调用属性检查刚刚的赋值");
        var pi = type.GetProperty("ID");
        Debug.Log("ID = "   pi.GetValue(obj, null));
}

10.LitJson(LitJson支持)

  • 直接参照手册中的代码即可。实际代码只需要两行即可完成相互转换。

11.ValueTypeBinding(值类型绑定)

  • 需要对应的值类型直接在InitializeILRuntime中绑定即可。
代码语言:javascript复制
//注册对应Binder
void InitializeILRuntime()
{
	......
        //这里做一些ILRuntime的注册,这里我们注册值类型Binder,注释和解注下面的代码来对比性能差别
        appdomain.RegisterValueTypeBinder(typeof(Vector3), new Vector3Binder());
        appdomain.RegisterValueTypeBinder(typeof(Quaternion), new QuaternionBinder());
        appdomain.RegisterValueTypeBinder(typeof(Vector2), new Vector2Binder());
}
  • 耗时对比:经过约100000数据运算

类型

注册耗时

不注册耗时

Vector3

105ms

2444ms

Quaternion

110ms

1685ms

vector2

107ms

2427ms

12.Performance(真机ILRuntime与Lua对比)

  • 首先打包程序为apk:
  • 遇到报错:JDK not found,解决方案比较麻烦,出现该错误的原因为该版本下的Unity先创建的普通3D模板转Android后会丢失JDK等组件,使用原有组件会报版本不匹配错误。故删除模板直接使用3D Andoid模板进行打包,顺利打包。
  • 安装到模拟器(雷电模拟器),效果演示:
  • Lua需要安装Xlua这里就不进行深入探索了。

0 人点赞