ATILRuntime 是在Unity编译器下进行ILRuntime开发的一组自动化工具.
Unity 2018.2.17f1 .NET Runtime4.X
应用场景:通常应用于自定义类型适配器的生成 注意:
- 需要自动生成适配器的类型需要被[NeedAdaptor]标记
- 适配器只会继承和实现抽象、虚方法,且只有适配器直接继承的类或接口的这些方法才能跨域重写
- 白名单中的接口和类型不需要被标记，会自动添加到生成名单中
- 热更工程中使用的各种Action、Func、主工程中的delegate的实例可以自动分析，然后注册
- 若需要为委托自动生成转换器，请用[DelegateExport]特性进行标记
- 通常，公共接口建议用[SingleInterfaceExport]标记，单独生成适配器做跨域继承.
- 有一种异常情况，比如一个类实现了一个接口的方法，但是这个方法时virtual,在生成适配器时，在同一个文件中会自动为这个接口也生成适配器(可能重复，重复删掉即可，这也是上一条建议的原因)
白名单如下图所示,所有在白名单中定义的类型或接口,将会自动生成适配器.下图白名单以树形图展示，方便查阅.
采用的自动分析功能来实现的自动绑定
热更工程中的public static修饰的方法可以进行单元测试(目前只实现了public static)
在热更工程中可以修复主工程的功能.
思想:
1.主工程中被[AllowHotfix]特性标记的都允许在热更工程中进行修复
2.修复的主要原理是:在主工程中增加一个委托实例,该实例的参数签名与我们要修复的方法的参数签名一致，然后在修复的方法判断该委托实例有没有被注册，若有则执行注册的方法
否则，则执行原有的逻辑(委托实例的生成是由工具自动完成的，我们只需要在允许修复的类型上面标记[AllowHotfix]特性即可，其它由工具自动完成)
3.在热更工程中为主工程中需要修复的委托实例注册方法:
- 提供白名单的可视化添加
- 完善单元测试的类型
- 目前Bug修复，只能修复主工程的方法.后期添加对字段、属性的修改
- 路径的数据持久化储存不使用EditorPrefs,因为不同工程之间数据会串，需要重新修改(已修复)
工具配置:
适配器自动生成:
先load之后,再去Generate
绑定代码自动生成:
配置好路径之后,直接Analysis
单元测试:
- load dll
- 选择需要进行的单元测试
- 点击单元测试按钮
代码注入:
代码注入是一个组合功能,通常在出包的时候才会使用:
先Bugfix生成方法的委托,然后在Inject,向Assembly-csharp.dll中注入代码
- 将白名单写入Json,并持久化保存(为后期直接在界面添加白名单准备)
修复Bug:
- 1.修复Adaptor生成时，命名空间出现需要手动修改的问题
- 2.修改持久化路径的方式,通过asset来保存,不再使用EditorPref
更新一些注意事项:
//1.
在适配器自动生成工程中 过滤 Bugfix 生成的委托:
用bugfix生成的委托实例,在我们进行 适配器自动生成 时需要忽略.具体修改如下:
GenerateILRuntimeAdapterWindow.LoadILScriptAssemblyClick()中 注释 >>//忽略Bugfix模式的下的委托实例的适配器生成
比如: 1.
在热更工程中，我若要修复主工程中的GameFramework.Taurus.TestMainHotfix.DoActionWithParams()方法,我在热更工程中则需要注册委托,如下所示:
如果命名空间与上图不一致,请在上面提到的地方修改，进行过滤
//2.
模板路径:
考虑到有同学会改变工程的目录结构,模板路径可能会变化,所以生成出来的文件内容为空
修改位置如下:
GenerateILRuntimeAdapterWindow.LoadTemplates()
测试用例还比较少，有些内容不够完善，之后我会慢慢完善这些内容,若有任何疑问，欢迎大家提 issue