简介
ILRuntime项目为基于C#的平台(例如Unity)提供了一个纯C#实现
,快速
、方便
且可靠
的IL运行时,使得能够在不支持JIT的硬件环境(如iOS)能够实现代码的热更新
官方教程
https://ourpalm.github.io/ILRuntime/public/v1/guide/tutorial.html
安装
Window->packageManager->搜索ILRuntime,可以安装对应组件
之后可以再packageManager页面导入ILRuntime的demo
相关demo的git地址为https://github.com/Ourpalm/ILRuntimeU3D
ILRuntimeDemo解析
这里以示例工程为例,跑一遍ILRuntime的热更流程
1.生成可热更的DLL文件
可热更工程HotFix所在目录为
Assets\Samples\ILRuntime\2.1.0\Demo\HotFix_Project~
用vs打开HotFix_Project.sln
选择HotFix_Project右键生成
生成成功之后会将对应的HotFix_Project.dll文件输出到StreamingAssets目录下
2.打开场景
所有demo场景的目录为ILRuntime/2.1.0/Demo/_Scenes/Examples
这里选择打开第一个demo场景01_HelloWorld
3.加载DLL文件
demo场景里面包含了一个HelloWorld的类,其中LoadHotFixAssembly逻辑主要是创建ILRuntime程序域,之后从StreamingAssets文件夹读取DLL文件,并且加载对应的程序及
IEnumerator LoadHotFixAssembly()
{
//首先实例化ILRuntime的AppDomain,AppDomain是一个应用程序域,每个AppDomain都是一个独立的沙盒
appdomain = new ILRuntime.Runtime.Enviorment.AppDomain();
//正常项目中应该是自行从其他地方下载dll,或者打包在AssetBundle中读取,平时开发以及为了演示方便直接从StreammingAssets中读取,
//正式发布的时候需要大家自行从其他地方读取dll
//!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
//这个DLL文件是直接编译HotFix_Project.sln生成的,已经在项目中设置好输出目录为StreamingAssets,在VS里直接编译即可生成到对应目录,无需手动拷贝
//工程目录在Assets\Samples\ILRuntime\1.6\Demo\HotFix_Project~
//以下加载写法只为演示,并没有处理在编辑器切换到Android平台的读取,需要自行修改
#if UNITY_ANDROID
WWW www = new WWW(Application.streamingAssetsPath + "/HotFix_Project.dll");
#else
WWW www = new WWW("file:///" + Application.streamingAssetsPath + "/HotFix_Project.dll");
#endif
while (!www.isDone)
yield return null;
if (!string.IsNullOrEmpty(www.error))
UnityEngine.Debug.LogError(www.error);
byte[] dll = www.bytes;
www.Dispose();
//PDB文件是调试数据库,如需要在日志中显示报错的行号,则必须提供PDB文件,不过由于会额外耗用内存,正式发布时请将PDB去掉,下面LoadAssembly的时候pdb传null即可
#if UNITY_ANDROID
www = new WWW(Application.streamingAssetsPath + "/HotFix_Project.pdb");
#else
www = new WWW("file:///" + Application.streamingAssetsPath + "/HotFix_Project.pdb");
#endif
while (!www.isDone)
yield return null;
if (!string.IsNullOrEmpty(www.error))
UnityEngine.Debug.LogError(www.error);
byte[] pdb = www.bytes;
fs = new MemoryStream(dll);
p = new MemoryStream(pdb);
try
{
appdomain.LoadAssembly(fs, p, new ILRuntime.Mono.Cecil.Pdb.PdbReaderProvider());
}
catch
{
Debug.LogError("加载热更DLL失败,请确保已经通过VS打开Assets/Samples/ILRuntime/1.6/Demo/HotFix_Project/HotFix_Project.sln编译过热更DLL");
}
InitializeILRuntime();
OnHotFixLoaded();
}
加载程序集完成之后调用OnHotFixLoaded,就是调用了热更工程中的HotFix_Project.InstanceClass类的StaticFunTest方法
void OnHotFixLoaded()
{
//HelloWorld,第一次方法调用
appdomain.Invoke("HotFix_Project.InstanceClass", "StaticFunTest", null, null);
}
打开HotFix工程中的InstanceClass.cs,可以看到对应的实现就是一个静态函数,简单地输出日志
public static void StaticFunTest()
{
UnityEngine.Debug.Log("!!! InstanceClass.StaticFunTest()");
}
运行该场景,可以看到最终运行结果。