下载: 中国特别版Unity,直接在PackageManager里可以直接找到ILRuntime 国际版Unity:在项目的的Packages/manifest.json,添加ILRuntime的源信息,在这个文件的dependencies节点前增加以下代码 “scopedRegistries”: [ { “name”: “ILRuntime”, “url”: “https://registry.npmjs.org”, “scopes”: [ “com.ourpalm” ] } ], 在打开Unity的PackageManager可以找到
如果还是找不到,那就在项目的manifest.json中的dependencies段的开头,增加如下代码手动将ILRuntime添加进项目 “com.ourpalm.ilruntime”: “1.6.0”, 安装完成后,可以在该面板倒入示例Demo 还是找不到可以在github上下载:https://github.com/Ourpalm/ILRuntimeU3D 在PlayerSettings-othersetting中勾选Allowunsafecode 在Assets\Samples\ILRuntime\1.6\Demo\HotFix_Project~目录中打开热更DLL的vs工程,直接编译,然后就可以正常运行ILRuntime的Demo示例了
原理:内置一个.netdll解释器,动态解释执行我们的dll 基于ILRuntime→开发逻辑代码→编译成DLL→放入远程库 程序开始运行→装载核心代码进入代码段后,运行程序(引擎代码,C#框架代码)→装载最新业务逻辑代码(热更DLL)执行完成游戏 Assets\Samples\ILRuntime\1.6\Demo\HotFix_Project~\HotFix_Project.csproj热更工程配置文件,使用记事本打开
简单使用:
1,生成一个AppDomain实例 2,加载DLL,(使用UnityWebRequest加载获取字节数组) 3,创建一个MemoryStream实例加载这个DLL字节数组 4,调用AppDomain.LoadAssembly(MemoryStream dll,MemoryStream pdb,new PdbReaderProvider()); 5,注册Unity工程中类适配器,特定结构体(Vector3,Quaternion),Unity特定委托,携程, 6,Unity调用热更新DLL方法:AppDomain.Invoke(“命名空间.类名”,“方法名”,“对象引用”,“参数列表”);
编写原则:
1,场景里面不放任何内容(场景为空,为了维护方便,美术做好东西给程序,利用代码加载出来) 2,运行的时候场景为空,没有必要切换场景,运行的时候只有一个场景 3,代码加载资源----》资源管理------》(ab或者aa) 4,业务逻辑代码全部写到ILRuntime的热更项目里面 5,尽量业务逻辑代码不继承Unity项目中的类(例如MonoBehaviour、Unity项目中自己创建的类)
实现:把逻辑代码与核心代码分离开来 Unity项目部分基本不会变动:启动代码+资源管理(aa,ab)+其他的管理
ILRuntime热更代码调用Unity代码 直接调用,如果是一些无法调用到的类,可以选择提前在Unity工程中做好接口给热更新调用(比如用反射),最好不要继承,如果要继承相当于跨域继承,需要写类适配器
通过类适配绑定热更新monobehaviour类的进行Inspector面板可视化操作,跟以前的写法差不多,[CustomEditor(typeof(MonoBehaviourAdapter.Adaptor), true)],重写 onInspectorGUI,获取ILinstance.Type.FieldMapping获取所有的字段字典,key为字段名字,value为字段索引,获取字段Type通过ILinstance.Type.FieldTypes[索引].CLRType,获取字段值通过ILInstance[索引],通过TypeForCLR获取Type类型,在通过反射进行编写,注意不能通过Property进行绘制
委托注册:
Unity工程声明的Func必须要先注册才能在热更中使用 Unity工程声明的无参Action可以直接在热更中使用 Unity工程声明的有参Action必须先注册才能在热更中使用 1,Action和Func注册: Action: appdomain.DelegateManager.RegisterMethodDelegate<参数列表>(); Func:最后一个参数是返回值 appdomain.DelegateManager.RegisterFunctionDelegate<参数列表>();
2,如果这个是在unity中自己定义的一个委托类型(例如UnityAction),需要进行下面的注册转换: //ILRuntime内部是用Action和Func这两个系统内置的委托类型来创建实例的,所以其他的委托类型都需要写转换器 //将Action或者Func转换成目标委托类型 appdomain.DelegateManager.RegisterDelegateConver<委托类型>((action)=>{ return new 委托类型((参数列表变量)=>{ //无返回值得 ((System.Action<参数列表>)action)(参数列表变量); //有返回值得 ((System.Func<参数列表>)action)(参数列表变量); }); });
注意事项: 1,热更新DLL中代码因为已经编译完成,所有这个DLL在Unity编辑器中运行时宏定义#if EDITOR不起作用 2,在DLL中可以使用Debug.Log输出信息,但是用不了Debug.Assert 3,
|