更新日期:2025年3月21日。
Github 仓库:https://github.com/SaiTingHu/HTFramework
Gitee 仓库:https://gitee.com/SaiTingHu/HTFramework
索引
一、ExceptionHandler异常处理器简介
异常处理器,当程序任何部位发生未知、未捕获的异常时,他会在这里被截获,并写入日志文件,同时支持在异常发生时打开指定程序(仅在PC平台),或者在异常发生时回馈日志到指定邮箱。
二、简略文档
快捷调用
通过如下方式快捷调用此模块:
HT.Framework.Main.m_Exception
公开字段
字段 | 描述 |
---|---|
无 | 无 |
公开属性
属性 | 描述 |
---|---|
ExceptionInfos | 当前捕获的所有异常信息 |
公开方法
方法 | 描述 |
---|---|
ReportMail | 回发邮件 |
ClearExceptionInfos | 清理所有异常信息 |
公开类型
类型 | 描述 |
---|---|
ExceptionInfo | 异常信息,用于描述一个异常的所有信息 |
公开接口
接口 | 描述 |
---|---|
无 | 无 |
公开特性
特性 | 描述 |
---|---|
无 | 无 |
三、使用ExceptionHandler
启用ExceptionHandler
在面板勾选Handler
开关,则启用了ExceptionHandler
异常处理器。
启用异常反馈程序
在面板勾选EnableFeedback
开关,则启用了异常反馈程序
(仅在PC平台)。
当触发任何未知异常时,将会启动面板设置的反馈程序。
启用邮件反馈
在面板勾选EnableMailReport
开关,则启用了邮件反馈
功能。
1.Host:邮箱服务器主机,根据你使用的
发送邮箱
,使用其对应的服务器主机,比如我这里的发送邮箱
为新浪邮箱,所以使用新浪的邮箱服务器主机。
2.Port:邮箱服务器主机端口。
3.Send Mail:发送邮箱。
4.Password:发送邮箱密码。
5.Receive Mail:接收邮箱。
6.Buffer Time:邮件发送缓冲时间。
注意:当发生了未知异常时,系统会使用【发送邮箱】将异常信息发送到【接收邮箱】。
订阅未知异常事件
在代码中可以直接订阅未知异常事件。
private void Start()
{
//订阅 EventException 异常事件
Main.m_Event.Subscribe<EventException>(OnException);
}
/// <summary>
/// 当未知异常发生
/// </summary>
private void OnException(object sender, EventHandlerBase eventHandler)
{
//Do something......
}
主动回发邮件
启用了ExceptionHandler
后,可以在任意位置、任意时候主动回发邮件,调用如下接口即可:
//回发邮件
Main.m_ExceptionHandler.ReportMail("邮件标题......", "邮件内容......");
四、运行时检视面板
在编辑器中运行时将会出现运行时检视面板
(Runtime Data),主要用以调试或数据监测,目前面板如下:
1.No Runtime Data!