我建议ILRuntime的官方手册作者罚抄《CLR via C#》100遍,看看人家怎么写教程的。
"scopedRegistries": [
{
"name": "ILRuntime",
"url": "https://registry.npmjs.org",
"scopes": [
"com.ourpalm"
]
}
],
(对应Examples 03)
//同一参数组合只需要注册一次 delegate void SomeDelegate(int a, float b); Actionact; //注册,不带返回值,最多支持五个参数传入 appDomain.DelegateManager.RegisterMethodDelegate (); //注册,带参数返回值,最后一个参数为返回值,最多支持四个参数传入 delegate bool SomeFunction(int a, float b); Func act;
app.DelegateManager.RegisterDelegateConvertor((action) => { return new SomeFunction((a, b) => { return ((Func )action)(a, b); }); });
public static StackObject* CreateInstance(ILIntepreter intp, StackObject* esp, List
public unsafe static StackObject* DLog(ILIntepreter __intp, StackObject* __esp, List
object[]
数组,这样不可避免的每次调用都会产生不少GC Alloc。众所周知GC Alloc高意味着在Unity中执行会存在较大的性能问题。//对LitJson进行注册,需要在注册CLR绑定之前
LitJson.JsonMapper.RegisterILRuntimeCLRRedirection(appdomain);
//LitJson使用
//将一个对象转换成json字符串
string json = JsonMapper.ToJson(obj);
//json字符串反序列化成对象
JsonTestClass obj = JsonMapper.ToObject(json);
//appdomain.LoadAssembly,他还有一个重载版本,只填入第一个steam,其余会自动补充为null
//第三个空填入new ILRuntime.Mono.Cecil.Pdb.PdbReaderProvider()
public void LoadAssembly(Stream stream, Stream symbol, ISymbolReaderProvider symbolReader)
//ILRuntime.Mono.Cecil.Pdb.PdbReaderProvider()
public ISymbolReader GetSymbolReader(ModuleDefinition module, string fileName);
public ISymbolReader GetSymbolReader(ModuleDefinition module, Stream symbolStream)
public object Invoke(string type, string method, object instance, params object[] p)
//方法实现
public object Invoke(string type, string method, object instance, params object[] p)
{
IType type2 = GetType(type);
if (type2 == null)
{
return null;
}
IMethod method2 = type2.GetMethod(method, (p != null) ? p.Length : 0);
if (method2 != null)
{
for (int i = 0; i < method2.ParameterCount; i++)
{
if (p[i] != null && !method2.Parameters[i].TypeForCLR.IsAssignableFrom(p[i].GetType()))
{
throw new ArgumentException("Parameter type mismatch");
}
}
return Invoke(method2, instance, p);
}
return null;
}
//普通调用
appdomain.Invoke("HotFix_Project.InstanceClass", "StaticFunTest", null, null);
//HotFix_Project.InstanceClass里的静态方法StaticFunTest
public static void StaticFunTest()
{
UnityEngine.Debug.Log("!!! InstanceClass.StaticFunTest()");
}
//传参调用
appdomain.Invoke("HotFix_Project.InstanceClass", "StaticFunTest2", null, 123);
//HotFix_Project.InstanceClass里的静态方法HotFix_Project.InstanceClass
public static void StaticFunTest2(int a)
{
UnityEngine.Debug.Log("!!! InstanceClass.StaticFunTest2(), a=" + a);
}
//泛型调用
public static void GenericMethod(T a)
{
UnityEngine.Debug.Log("!!! InstanceClass.GenericMethod(), a=" + a);
}
//多值调用ref/out
public void RefOutMethod(int addition, out List lst, ref int val)
{
val = val + addition + id;
lst = new List();
lst.Add(id);
}
Debug.Log("通过IMethod调用方法");
//预先获得IMethod,可以减低每次调用查找方法耗用的时间
IType type = appdomain.LoadedTypes["HotFix_Project.InstanceClass"];
//根据方法名称和参数个数获取方法
IMethod method = type.GetMethod("StaticFunTest2", 1);
appdomain.Invoke(method, null, 123);
void InitializeILRuntime()
{
#if DEBUG && (UNITY_EDITOR || UNITY_ANDROID || UNITY_IPHONE)
//由于Unity的Profiler接口只允许在主线程使用,为了避免出异常,需要告诉ILRuntime主线程的线程ID才能正确将函数运行耗时报告给Profiler
appdomain.UnityMainThreadID = System.Threading.Thread.CurrentThread.ManagedThreadId;
#endif
//这里做一些ILRuntime的注册
//TestDelegateMethod, 这个委托类型为有个参数为int的方法,注册仅需要注册不同的参数搭配即可
appdomain.DelegateManager.RegisterMethodDelegate();
//带返回值的委托的话需要用RegisterFunctionDelegate,返回类型为最后一个
appdomain.DelegateManager.RegisterFunctionDelegate();
//Action 的参数为一个string
appdomain.DelegateManager.RegisterMethodDelegate();
//ILRuntime内部是用Action和Func这两个系统内置的委托类型来创建实例的,所以其他的委托类型都需要写转换器
//将Action或者Func转换成目标委托类型
appdomain.DelegateManager.RegisterDelegateConvertor((action) =>
{
//转换器的目的是把Action或者Func转换成正确的类型,这里则是把Action转换成TestDelegateMethod
return new TestDelegateMethod((a) =>
{
//调用委托实例
((System.Action)action)(a);
});
});
//对于TestDelegateFunction同理,只是是将Func转换成TestDelegateFunction
appdomain.DelegateManager.RegisterDelegateConvertor((action) =>
{
return new TestDelegateFunction((a) =>
{
return ((System.Func)action)(a);
});
});
//下面再举一个这个Demo中没有用到,但是UGUI经常遇到的一个委托,例如UnityAction
appdomain.DelegateManager.RegisterDelegateConvertor>((action) =>
{
return new UnityEngine.Events.UnityAction((a) =>
{
((System.Action)action)(a);
});
});
}
//补充
//从源码中可以看到以下两种注册都是使用Action和Func进行实现的,整合后会转递给:public void RegisterDelegateConvertor(Func action)
//RegisterMethodDelegate最多支持五个泛型
public void RegisterMethodDelegate()
//RegisterFunctionDelegate最多支持五个泛型,最后一个是返回值
public void RegisterFunctionDelegate()
public void RegisterFunctionDelegate()
//热更类
public abstract class TestClassBase
{
public virtual int Value
{
get
{
return 0;
}
set
{
}
}
public virtual void TestVirtual(string str)
{
Debug.Log("!! TestClassBase.TestVirtual, str = " + str);
}
public abstract void TestAbstract(int gg);
}
//加载后处理
void OnHotFixLoaded()
{
Debug.Log("首先我们来创建热更里的类实例");
TestClassBase obj;
Debug.Log("现在我们来注册适配器, 该适配器由ILRuntime/Generate Cross Binding Adapter菜单命令自动生成");
appdomain.RegisterCrossBindingAdaptor(new TestClassBaseAdapter());
Debug.Log("现在再来尝试创建一个实例");
//这里的TestInheritance为public class TestInheritance : TestClassBase
//appdomain.Instantiate:public T Instantiate(string type, object[] args = null)
obj = appdomain.Instantiate("HotFix_Project.TestInheritance");
Debug.Log("现在来调用成员方法");
obj.TestAbstract(123);
obj.TestVirtual("Hellopublic T Instantiate(string type, object[] args = null)
obj.Value = 233;//public override int Value { get; set; }
Debug.LogFormat("obj.Value={0}", obj.Value);
Debug.Log("现在换个方式创建实例");
obj = appdomain.Invoke("HotFix_Project.TestInheritance", "NewObject", null, null) as TestClassBase;
obj.TestAbstract(456);
obj.TestVirtual("Foobar");
obj.Value = 2333333;
Debug.LogFormat("obj.Value={0}", obj.Value);
}
unsafe void InitializeILRuntime()
{
...
//这里做一些ILRuntime的注册
var mi = typeof(Debug).GetMethod("Log", new System.Type[] { typeof(object) });
//Log_11为重定向方法
appdomain.RegisterCLRMethodRedirection(mi, Log_11);
}
unsafe void OnHotFixLoaded()
{
Debug.Log("请注释和解除InitializeILRuntime方法里的重定向注册,对比下一行日志的变化");
//注册时显示:call System.Void UnityEngine.Debug::Log(System.Object)
/*注释时显示:System.Reflection.MethodBase:Invoke (object,object[])
ILRuntime.CLR.Method.CLRMethod:Invoke*/
appdomain.Invoke("HotFix_Project.TestCLRRedirection", "RunTest", null, null);
}
//CLR绑定,放在void InitializeILRuntime()里的末尾部分
ILRuntime.Runtime.Generated.CLRBindings.Initialize(appdomain);
void Update()
{
if (ilruntimeReady && !executed && Time.realtimeSinceStartup > 3)
{
executed = true;
//这里为了方便看Profiler,代码挪到Update中了
System.Diagnostics.Stopwatch sw = new System.Diagnostics.Stopwatch();
var type = appdomain.LoadedTypes["HotFix_Project.TestCLRBinding"];
var m = type.GetMethod("RunTest", 0);
Debug.Log("请解除InitializeILRuntime方法中的注释对比有无CLR绑定对运行耗时和GC开销的影响");
sw.Reset();
sw.Start();
//使用直接调用的方法
Profiler.BeginSample("RunTest");
appdomain.Invoke("HotFix_Project.TestCLRBinding", "RunTest", null, null);
/*使用指定位置后调用的方法
Profiler.BeginSample("RunTest2");
appdomain.Invoke(m, null, null);*/
Profiler.EndSample();
sw.Stop();
Debug.LogFormat("刚刚的方法执行了:{0} ms", sw.ElapsedMilliseconds);
Debug.Log("可以看到运行时间和GC Alloc有大量的差别,RunTest2之所以有20字节的GC Alloc是因为Editor模式ILRuntime会有调试支持,正式发布(关闭Development Build)时这20字节也会随之消失");
}
}
void InitializeILRuntime()
{
...
//使用Couroutine时,C#编译器会自动生成一个实现了IEnumerator,IEnumerator
void OnHotFixLoaded()
{
Debug.Log("热更DLL中的类型我们均需要通过AppDomain取得");
var it = appdomain.LoadedTypes["HotFix_Project.InstanceClass"];
Debug.Log("LoadedTypes返回的是IType类型,但是我们需要获得对应的System.Type才能继续使用反射接口");
var type = it.ReflectionType;
Debug.Log("取得Type之后就可以按照我们熟悉的方式来反射调用了");
//返回为当前 Type 定义的所有公共构造函数。
var ctor = type.GetConstructor(new System.Type[0]);
var obj = ctor.Invoke(null);
Debug.Log("打印一下结果");
Debug.Log(obj);
Debug.Log("我们试一下用反射给字段赋值");
var fi = type.GetField("id", System.Reflection.BindingFlags.NonPublic | System.Reflection.BindingFlags.Instance);
fi.SetValue(obj, 111111);
Debug.Log("我们用反射调用属性检查刚刚的赋值");
var pi = type.GetProperty("ID");
Debug.Log("ID = " + pi.GetValue(obj, null));
}
//注册对应Binder
void InitializeILRuntime()
{
......
//这里做一些ILRuntime的注册,这里我们注册值类型Binder,注释和解注下面的代码来对比性能差别
appdomain.RegisterValueTypeBinder(typeof(Vector3), new Vector3Binder());
appdomain.RegisterValueTypeBinder(typeof(Quaternion), new QuaternionBinder());
appdomain.RegisterValueTypeBinder(typeof(Vector2), new Vector2Binder());
}
//注册对应Binder
void InitializeILRuntime()
{
......
//这里做一些ILRuntime的注册,这里我们注册值类型Binder,注释和解注下面的代码来对比性能差别
appdomain.RegisterValueTypeBinder(typeof(Vector3), new Vector3Binder());
appdomain.RegisterValueTypeBinder(typeof(Quaternion), new QuaternionBinder());
appdomain.RegisterValueTypeBinder(typeof(Vector2), new Vector2Binder());
}
类型 | 注册耗时 | 不注册耗时 |
---|---|---|
Vector3 | 105ms | 2444ms |
Quaternion | 110ms | 1685ms |
vector2 | 107ms | 2427ms |