更新日期:9月27日。
Github源码:[点我获取源码]
Gitee源码:[点我获取源码]
索引
ILHotfix热更新模块简介使用ILHotfix热更新创建ILHotfix环境创建ILHotfix流程设置资源加载模式运行代码中启动热更新ILHotfix热更新模块简介
基于ILRuntime实现的跨平台热更新方案,开发非常方便,新项目只需要拉取框架源码后,一键即可创建热更新环境,之后便可以正常开发。
使用ILHotfix热更新
创建ILHotfix环境
1.对于新项目,只要在工程中包含了HTFrameworkILHotfix模块,则自动启用了ILHotfix,勾选面板的Auto StartUp开关,则在初始化时便自动启动热更新逻辑,否则,需要手动在代码中调用ILHotfixManager的启动方法。
2.与框架源生的Hotfix相同,点击下面的Create ILHotfix Environment按钮便可一键创建ILHotfix环境。
3.创建完成后,面板会显示ILHotfix环境已成功创建的提示,同时,红色外框标记的便为此项目中ILHotfix代码的根目录,之后的ILHotfix代码可以按照常规C#代码的方式编写,但必须放在此目录下才会被认为是ILHotfix代码。
4.ILHotfix环境目录非常简单:
A.ILHotfix代码的根目录,新建的ILHotfix脚本都必须放在此目录下。
→ILHotfixEnvironment为自动生成的热更新环境类,理论上你不需要改其中任何代码,当然,也支持扩展它。
→ILHotfix.dll为我们热更的目标库(每次编译后会自动覆盖最新的),发布时只需将之打入指定AB包,并在B面板指定AB包名称及路径。
B.热更目标库打入的AB包名称及路径,如果没有特殊需求,这些可以保持默认值,热更目标库也始终放在A路径下。
创建ILHotfix流程
创建完ILHotfix环境后,我们直接运行就已经开始执行ILHotfix逻辑了,只不过此时的ILHotfix库为空,我们需要创建至少一个ILHotfix流程(与主框架类似,流程也是ILHotfix的生命周期)。
访问权限:ILHotfix代码能正常访问框架代码,但任何地方都无法访问ILHotfix代码!通过ILRunTime提供的方法可以使ILHotfix代码和外部代码以某种方式进行交互,可自行参见ILRunTime用户手册,不过应尽量避免这种跨域的访问。
推荐使用快捷创建方式:
Project界面右键->Create->HTFramework ILHotfix->C# ILHotfixProcedure Script
如下,我新建了一个名为Entrance的热更新流程,ILHotfixProcedureState.Entrance标记表明这是ILHotfix逻辑的入口流程:
/// <summary>/// 新建热更新流程/// </summary>[ILHotfixProcedureState(ILHotfixProcedureState.Entrance)]public class Entrance : ILHotfixProcedure{/// <summary>/// 流程初始化/// </summary>public override void OnInit(){GlobalTools.LogInfo("初始化 " + typeof(Entrance).Name + " 流程!");}/// <summary>/// 进入流程/// </summary>public override void OnEnter(){GlobalTools.LogInfo("进入 " + typeof(Entrance).Name + " 流程!");}/// <summary>/// 离开流程/// </summary>public override void OnLeave(){GlobalTools.LogInfo("离开 " + typeof(Entrance).Name + " 流程!");}/// <summary>/// 流程帧刷新/// </summary>public override void OnUpdate(){Debug.Log(typeof(Entrance).Name + " 流程更新!");}/// <summary>/// 流程帧刷新(秒)/// </summary>public override void OnUpdateSecond(){}}
在新建一个普通的流程Normal:
/// <summary>/// 新建热更新流程/// </summary>[ILHotfixProcedureState(ILHotfixProcedureState.Normal)]public class Normal : ILHotfixProcedure{/// <summary>/// 流程初始化/// </summary>public override void OnInit(){GlobalTools.LogInfo("初始化 " + typeof(Normal).Name + " 流程!");}/// <summary>/// 进入流程/// </summary>public override void OnEnter(){GlobalTools.LogInfo("进入 " + typeof(Normal).Name + " 流程!");}/// <summary>/// 离开流程/// </summary>public override void OnLeave(){GlobalTools.LogInfo("离开 " + typeof(Normal).Name + " 流程!");}/// <summary>/// 流程帧刷新/// </summary>public override void OnUpdate(){Debug.Log(typeof(Normal).Name + " 流程更新!");}/// <summary>/// 流程帧刷新(秒)/// </summary>public override void OnUpdateSecond(){}}
我们在入口流程中切换流程:
/// <summary>/// 流程帧刷新/// </summary>public override void OnUpdate(){Debug.Log(typeof(Entrance).Name + " 流程更新!");//鼠标左键双击时切换流程if (Main.m_Input.GetButtonDown(InputButtonType.MouseLeftDoubleClick)){//切换至 Normal 流程ILHotfixEnvironment.Environment.SwitchProcedure<Normal>();}}
设置资源加载模式
热更新必须使用AssetBundle加载模式,如果没有切换至该模式,将无法初始化热更新环境。
运行
然后我们直接运行场景就可以了,勾选AutoStartUp开关,让其自动启动热更新逻辑(因为是测试,所以我们不需要判断热更新库的版本并下载新版这个过程)。
接下来我们双击左键,可以看到已经正确的切换了流程:
之后可以在ILHotfix流程中扩展自己的代码,以及创建新的流程,不过,发布项目前务必确保最新的ILHotfix库已经被打入了AB包中!
注意:理论上ILHotfix与框架源生的Hotfix不冲突,两者可以共存,但同一个项目中没有同时使用两种方式的必要。
代码中启动热更新
//当检测热更新库版本、下载最新版库等操作完成后,启动热更新逻辑ILHotfixManager.Current.StartUp();