CRIWARE Unity Plugin Manual  Last Updated: 2024-07-12
CRIWARE Error Handler (CRIWARE错误句柄)
用于启用CRIWARE错误输出的组件。
创建组件后,CRIWARE将启用对內部检测到的警告和错误的通知。
仅在开发期间使用此组件,并请在发布应用程序时将其禁用。

adx2u_errorhandler_float.png

[备注]
(*1) 也可以从[GameObject]-> [CRIWARE]-> [Create CRIWARE Error Handler]菜单中创建CRIWARE Error Handler。这时会作为GameObject进行创建。
(*2) 当多个错误​​/警告同时发生时,某些错误/警告可能会被省略。如果要检查所有错误/警告时,请同时选中以下的[Print Debug On Terminal]复选框。

Print Debug On Terminal选择框
如果启用此复选框,则所有CRIWARE错误/警告将与Unity Editor的控制台输出分开输出到每个设备的输出目标。
对于每个设备,启用复选框时显示的错误输出目标如下。

Print Debug On Terminal的输出目标
设备 输出目标
Windows Visual Studio的调试输出窗口:
可以通过添加Unity来查看错误报告。
Mac OS X 终端标准输出
iOS Xcode控制台输出
Android LogCat:
通过"CRIWARE Unity Plugin"标签输出。
Force Crash on Error复选框
启用此复选框时,则当此组件检测到CRIWARE警告或错误时,应用程序将立即强制崩溃。
可用于在实际设备上运行应用程序时确认有无错误发生。
注意
使用此功能时,如果发生此插件引起的警告或错误,Unity编辑器也会一同发生崩溃。
使用Unity编辑器进行开发时,请禁用此功能。

Do Not Destroy On Load复选框
当本复选框不被选中时,CRIWARE Error Handler组件将在场景转换时丢弃。
基本上建议您启用检查,以便可以处理跨场景的错误。
Error list length 栏
设置发生错误时在一个应用程序帧中处理的最大错误数。
如果一次产生的错误数量超过了设定的数量,则将跳过日志等的输出。
详细信息,请参照 CriWareErrorHandler.messageBufferCounts 。