graphic_log

Functions

自由函数

OHOS::GRAPHIC_LOGF

void OHOS::GRAPHIC_LOGF(const char* fmt, ...)

功能说明

• 核心用途：输出 Fatal 级别日志信息
• 设计目的：为图形子系统提供致命错误级别的日志输出能力
• 使用场景：不可恢复的严重错误发生时调用，记录致命错误位置与上下文

入参

名称	参数类型	详细说明	约束取值范围
fmt	const char*	格式化字符串，与 printf 格式规范一致	非空字符串
...	...	可变参数列表，与 fmt 中的格式占位符对应	与 fmt 占位符匹配

Kconfig 配置

配置项	说明	默认值
ENABLE_GRAPHIC_LOG	图形日志总开关，未开启时所有日志宏展开为空	1（3322 平台）/ 0（默认）
GRAPHIC_LOG_LEVEL	日志输出级别阈值，仅输出级别不大于该值的日志	2（3322 平台）/ 5（默认）

---

OHOS::GRAPHIC_LOGE

void OHOS::GRAPHIC_LOGE(const char* fmt, ...)

功能说明

• 核心用途：输出 Error 级别日志信息
• 设计目的：为图形子系统提供错误级别的日志输出能力
• 使用场景：可恢复的运行时错误发生时调用，记录错误详情与调用位置

入参

名称	参数类型	详细说明	约束取值范围
fmt	const char*	格式化字符串，与 printf 格式规范一致	非空字符串
...	...	可变参数列表，与 fmt 中的格式占位符对应	与 fmt 占位符匹配

Kconfig 配置

配置项	说明	默认值
ENABLE_GRAPHIC_LOG	图形日志总开关，未开启时所有日志宏展开为空	1（3322 平台）/ 0（默认）
GRAPHIC_LOG_LEVEL	日志输出级别阈值，仅输出级别不大于该值的日志	2（3322 平台）/ 5（默认）

---

OHOS::GRAPHIC_LOGW

void OHOS::GRAPHIC_LOGW(const char* fmt, ...)

功能说明

• 核心用途：输出 Warning 级别日志信息
• 设计目的：为图形子系统提供警告级别的日志输出能力
• 使用场景：潜在问题或异常条件发生时调用，记录警告信息以供排查

入参

名称	参数类型	详细说明	约束取值范围
fmt	const char*	格式化字符串，与 printf 格式规范一致	非空字符串
...	...	可变参数列表，与 fmt 中的格式占位符对应	与 fmt 占位符匹配

Kconfig 配置

配置项	说明	默认值
ENABLE_GRAPHIC_LOG	图形日志总开关，未开启时所有日志宏展开为空	1（3322 平台）/ 0（默认）
GRAPHIC_LOG_LEVEL	日志输出级别阈值，仅输出级别不大于该值的日志	2（3322 平台）/ 5（默认）

---

OHOS::GRAPHIC_LOGI

void OHOS::GRAPHIC_LOGI(const char* fmt, ...)

功能说明

• 核心用途：输出 Info 级别日志信息
• 设计目的：为图形子系统提供信息级别的日志输出能力
• 使用场景：记录关键流程节点、状态变更等常规运行信息

入参

名称	参数类型	详细说明	约束取值范围
fmt	const char*	格式化字符串，与 printf 格式规范一致	非空字符串
...	...	可变参数列表，与 fmt 中的格式占位符对应	与 fmt 占位符匹配

Kconfig 配置

配置项	说明	默认值
ENABLE_GRAPHIC_LOG	图形日志总开关，未开启时所有日志宏展开为空	1（3322 平台）/ 0（默认）
GRAPHIC_LOG_LEVEL	日志输出级别阈值，仅输出级别不大于该值的日志	2（3322 平台）/ 5（默认）

---

OHOS::GRAPHIC_LOGD

void OHOS::GRAPHIC_LOGD(const char* fmt, ...)

功能说明

• 核心用途：输出 Debug 级别日志信息
• 设计目的：为图形子系统提供调试级别的日志输出能力
• 使用场景：开发调试阶段输出详细运行时信息，辅助问题定位与逻辑跟踪

入参

名称	参数类型	详细说明	约束取值范围
fmt	const char*	格式化字符串，与 printf 格式规范一致	非空字符串
...	...	可变参数列表，与 fmt 中的格式占位符对应	与 fmt 占位符匹配

Kconfig 配置

配置项	说明	默认值
ENABLE_GRAPHIC_LOG	图形日志总开关，未开启时所有日志宏展开为空	1（3322 平台）/ 0（默认）
GRAPHIC_LOG_LEVEL	日志输出级别阈值，仅输出级别不大于该值的日志	2（3322 平台）/ 5（默认）

---

OHOS::GRAPHIC_LOGP

void OHOS::GRAPHIC_LOGP(const char* fmt, ...)

功能说明

• 核心用途：输出纯文本日志信息（不带级别前缀和位置信息）
• 设计目的：为图形子系统提供无级别标注的简单打印能力
• 使用场景：需要输出自定义格式文本且不需要自动附加级别和位置标签时调用

入参

名称	参数类型	详细说明	约束取值范围
fmt	const char*	格式化字符串，与 printf 格式规范一致	非空字符串
...	...	可变参数列表，与 fmt 中的格式占位符对应	与 fmt 占位符匹配

Kconfig 配置

配置项	说明	默认值
ENABLE_GRAPHIC_LOG	图形日志总开关，未开启时该宏展开为空	1（3322 平台）/ 0（默认）

Enumerations

LOG_LEVEL

typedef enum {
    LOG_LEVEL_FATAL = 0,
    LOG_LEVEL_ERROR = 1,
    LOG_LEVEL_WARN = 2,
    LOG_LEVEL_INFO = 3,
    LOG_LEVEL_DEBUG = 4,
    LOG_LEVEL_MAX = 5,
} LOG_LEVEL;

枚举成员	取值	描述
LOG_LEVEL_FATAL	0	致命错误级别
LOG_LEVEL_ERROR	1	错误级别
LOG_LEVEL_WARN	2	警告级别
LOG_LEVEL_INFO	3	信息级别
LOG_LEVEL_DEBUG	4	调试级别
LOG_LEVEL_MAX	5	日志级别上限，非有效日志级别，用于边界判断