下载:
中国特别版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,