跳转至

AesirArchitectureDebug

  • 种类: static class
  • 命名空间: Runestone.AesirArchitecture
  • 程序集: Runestone.AesirArchitecture

继承链: System.Object → AesirArchitectureDebug

声明

public static class AesirArchitectureDebug

AesirArchitecture 内部日志工具。 所有架构模块的日志输出应走此工具,以醒目的颜色和 [AesirArchitecture] 标识区分来源。 Log/Warning 通过 [Conditional] 在打包时自动剔除;Error 始终保留。

备注

编译行为差异: Log 与 LogWarning 系列方法标注了 [Conditional("UNITY_EDITOR")], 在非编辑器构建时编译器会自动移除所有调用点,不会产生任何运行时开销。 LogError 系列方法未使用 [Conditional] 特性,在所有构建中均保留, 因为错误日志在生产环境中同样需要可见,以便定位问题。

字段

名称 描述
ErrorTag Error 级别的富文本标签,供异常消息复用以保持控制台输出风格一致。

ErrorTag

Error 级别的富文本标签,供异常消息复用以保持控制台输出风格一致。

备注

此常量供 CapabilityExtensions 的异常消息复用, 确保抛出的异常在控制台中与直接调用 LogError(string) 保持一致的 [AesirArchitecture] 标识风格, 便于开发者快速识别错误来源。

public const string ErrorTag = "<color=#FF4444><b>[AesirArchitecture]</b></color>";

方法

声明的方法

名称 描述
Log(object, string) 输出 Log 级别消息,附带来源标识
Log(string) 输出 Log 级别消息
LogError(object, string) 输出 Error 级别消息,附带来源标识
LogError(string) 输出 Error 级别消息
LogTestInfo(object, string) 输出单元测试日志消息,附带来源标识
LogTestInfo(string) 输出单元测试日志消息。 仅在定义了 UNITY_INCLUDE_TESTS 的程序集中生效,非测试构建自动剔除调用。
LogWarning(object, string) 输出 Warning 级别消息,附带来源标识
LogWarning(string) 输出 Warning 级别消息

继承的方法

名称 描述 声明类型
GetType() — object
Equals(object) — object
GetHashCode() — object
ToString() — object
MemberwiseClone() — object
Finalize() — object

Log(object, string)

输出 Log 级别消息,附带来源标识

[Conditional]
public static void Log(object source, string message)

参数

名称 类型 说明
source object 日志来源标识,通常传入 nameof(TypeName) 以便快速定位日志产生的模块
message string 日志内容

Log(string)

输出 Log 级别消息

[Conditional]
public static void Log(string message)

参数

名称 类型 说明
message string —

LogError(object, string)

输出 Error 级别消息,附带来源标识

public static void LogError(object source, string message)

参数

名称 类型 说明
source object 日志来源标识,通常传入 nameof(TypeName) 以便快速定位日志产生的模块
message string 错误内容

LogError(string)

输出 Error 级别消息

public static void LogError(string message)

参数

名称 类型 说明
message string —

LogTestInfo(object, string)

输出单元测试日志消息,附带来源标识

备注

该方法使用 [Conditional("UNITY_INCLUDE_TESTS")] 特性, 仅在包含测试代码的程序集编译时保留调用,正式发布构建中自动移除。

[Conditional]
public static void LogTestInfo(object source, string message)

参数

名称 类型 说明
source object 日志来源标识,通常传入 nameof(TypeName) 以便快速定位日志产生的模块
message string 测试日志内容

LogTestInfo(string)

输出单元测试日志消息。 仅在定义了 UNITY_INCLUDE_TESTS 的程序集中生效,非测试构建自动剔除调用。

备注

该方法使用 [Conditional("UNITY_INCLUDE_TESTS")] 特性, 仅在包含测试代码的程序集编译时保留调用。在正式发布构建中 Unity 不会定义 UNITY_INCLUDE_TESTS, 所有调用点都会被编译器自动移除,确保测试日志不会泄漏到生产环境。

[Conditional]
public static void LogTestInfo(string message)

参数

名称 类型 说明
message string 测试日志内容

LogWarning(object, string)

输出 Warning 级别消息,附带来源标识

[Conditional]
public static void LogWarning(object source, string message)

参数

名称 类型 说明
source object 日志来源标识,通常传入 nameof(TypeName) 以便快速定位日志产生的模块
message string 警告内容

LogWarning(string)

输出 Warning 级别消息

[Conditional]
public static void LogWarning(string message)

参数

名称 类型 说明
message string —

Additional Notes

首个 ## Additional Notes 是增量生成文档标识符,请勿修改标题级别和内容!本文档由 Script Doc Generator 辅助生成。