ILRuntime官方Demo笔记

官方Demo地址:https://github.com/Ourpalm/ILRuntimeU3D

基于ILRuntime 1.6.3版本,在unity2019.3.7f1下测试

调用/执行 热更中的方法

调用热更代码中方法,写在AppDomain中,记录一下主要几个方法:

AppDomain.LoadAssembly 加载热更dll

执行热更代码的方法,有两种方式:

  1. appdomain.Invoke("HotFix_Project.InstanceClass", "StaticFunTest", null, null);
  1. 预先获得IMethod,可以减低每次调用查找方法耗用的时间,代码如下:
//预先获得IMethod,可以减低每次调用查找方法耗用的时间
IType type = appdomain.LoadedTypes["HotFix_Project.InstanceClass"];
//根据方法名称和参数个数获取方法
IMethod method = type.GetMethod("StaticFunTest", 0);

appdomain.Invoke(method, null, null);

也可以在主工程中抛出事件,在热更工程中监听,原理和Invoke是一样的

监听主工程的委托

在热更工程中监听主工程的事件,由主工程触发。

如果非Action或Func,则需要在主工程中写适配器,所以建议使用系统自带的Action和Func。

继承主工程,实现主工程接口

因为跨域继承必须要注册适配器。 如果是热更DLL里面继承热更里面的类型,不需要任何注册。

适配器代码怎么写

Demo中有三个适配器示例,都继承自CrossBindingAdaptor,适配器中有内部类,继承或实现接口的方法。

public class MonoBehaviourAdapter : CrossBindingAdaptor
{
    public override Type BaseCLRType {get { return typeof(MonoBehaviour); } }

    public override Type AdaptorType {get { return typeof(Adaptor); } }

    public override object CreateCLRInstance(ILRuntime.Runtime.Enviorment.AppDomain appdomain, ILTypeInstance instance)
    {
        return new Adaptor(appdomain, instance);
    }
    //为了完整实现MonoBehaviour的所有特性,这个Adapter还得扩展,这里只抛砖引玉,只实现了最常用的Awake, Start和Update
    public class Adaptor : MonoBehaviour, CrossBindingAdaptorType
    {
        ILTypeInstance instance;
        ILRuntime.Runtime.Enviorment.AppDomain appdomain;
        public Adaptor()
        {
        }
        public Adaptor(ILRuntime.Runtime.Enviorment.AppDomain appdomain, ILTypeInstance instance)
        {
            this.appdomain = appdomain;
            this.instance = instance;
        }
        public ILTypeInstance ILInstance { get { return instance; } set { instance = value; } }
        public ILRuntime.Runtime.Enviorment.AppDomain AppDomain { get { return appdomain; } set { appdomain = value; } }
        public void Awake() {}
        void Start(){}
        void Update(){ }
        public override string ToString(){ }
    }
}

注:1.6版本开始提供了半自动生成适配器代码

在写了适配器之后,热更中访问的是xxx_Adapter.cs中的方法和字段

CLR重定向/热补丁

CLRRedirectionDemo,需要在AppDomain中注册 RegisterCLRMethodRedirection

在热更工程中调用主工程的代码时会重定向新的实现,新手可以从修改CLR生成的绑定代码开始。

例子是修改Debug.Log方法,在热更中打印的日志也能显示堆栈信息。

生成CLR绑定代码

类似于slua/tolua/xlua一样, 把在热更工程会用到主工程的类添加到列表中,然后生成绑定代码。

ILRuntime提供一个智能分析在热更工程会访问主工程的代码并生成CLR绑定代码。

在CLRBindingDemo示例中生成CLR绑定代码之后性能提升10倍

在生成绑定代码之后,热更中访问主工程中方法是调用的 xxx_Binding.cs,而如果不生成则是通过反射调用。

在热更工程使用协程

官方例子是调用主工程的方法来启动协程,我测试热更工程也可以调用MonoBehaviour的方法开启协程。

热更工程代码如下:

public static void RunTest()
{
	Debug.Log("热更工程中开启协程");
	CoroutineDemo.Instance.StartCoroutine(Coroutine());
}

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

对主工程的值类型做绑定

那些需要做绑定?Unity的常用值类型,比如:Vector3,Vector2

这项操作会提升性能,减少额外的CPU开销和GC Alloc。

方法:

AppDomain.RegisterValueTypeBinder(typeof(Vector3), new Vector3Binder());

Demo 做了十万次向量的运算,添加值类型绑定,不绑定的耗时如下:

Value: a=(100001.0, 100002.0, 100003.0),dot=0, time = 750ms
Value: a=(100001.0, 100002.0, 100003.0),dot=0, time = 1911ms

Value: a=(-0.4, -0.8, -1.7, -5.1),dot=-124.7494, time = 604ms
Value: a=(-0.4, -0.8, -1.7, -5.1),dot=-124.7494, time = 1550ms

Value: a=(100001.0, 100002.0),dot=0, time = 710ms
Value: a=(100001.0, 100002.0),dot=0, time = 1902ms

我的小结

可以把热更工程的VS项目(HotFix_Project.csproj)添加到Unity生成的解决方案中(ILRuntimeDemo.sln),在开发期不用两个工程切换。

由于Unity 2018和Unity5的目录结构调整,**Library\UnityAssemblies\ **在Unity2018目录没有

所以我在热更工程引用 Unity_2018_2_7f1\Editor\Data\Managed\UnityEngine\UnityEngine.CoreModule.dll

热更工程最常做的事情

根据我们以往的项目使用Lua做为热更脚本为例,我们在热更工程做的最多的事情:

  • 在热更工程中调用主工程的方法,或监听主工程的事件,监听Unity组件触发的事件。

  • 热更工程调用主工程接口加载资源

  • 热更工程处理UI代码逻辑

  • 读取配置,对配置解析

  • 热更工程中处理网络的回调

  • 热更工程基本处理所有的业务逻辑

为什么要写适配器

因为ILRuntime可以理解为蓝大写的C#虚拟机,这个虚拟机要在运行时和Unity的脚本进行交互。

由于IOS的AOT限制,在运行时ILRuntime中是不知道Unity中的类型,所以需要我们在主工程写适配器让ILRuntime知道如何调用在Unity的代码,或当Unity的事件触发时让ILRuntime能够监听到。

posted @ 2019-03-01 20:12  赵青青  阅读(5202)  评论(0编辑  收藏