ILRuntime 使用教程

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