IMSLog Class Reference

Inherits from NSObject
Declared in IMSLog.h

Overview

日志模块,提供客户端统一日志打印,日志等级控制,分模块日志隔离等能力,同时支持拓展日志输出的能力。

+ registerTag:

注册需要输出日志的 tag

+ (void)registerTag:(NSString *_Nonnull)tag

Parameters

tag

标签

Discussion

注册需要输出日志的 tag

日志模块以 tag 为维度对日志进行等级控制、隔离等操作,建议使用模块名称作为tag。

Declared In

IMSLog.h

+ setAllTagsLevel:

统一设置所有 tag 的显示日志级别

+ (void)setAllTagsLevel:(IMSLogLevel)level

Parameters

level

日志级别

Discussion

统一设置所有 tag 的显示日志级别

若 tag 未设置级别,将不会输出对应 tag 的日志。

Declared In

IMSLog.h

+ setLevel:forTag:

设置 tag 对应的显示日志级别

+ (void)setLevel:(IMSLogLevel)level forTag:(NSString *_Nonnull)tag

Parameters

level

日志级别

tag

标签

Discussion

设置 tag 对应的显示日志级别

若 tag 未设置级别,将不会输出对应 tag 的日志。

Declared In

IMSLog.h

+ showInConsole:

在控制台打印日志

+ (void)showInConsole:(BOOL)show

Discussion

在控制台打印日志

建议在 release 版本中关闭打印

Declared In

IMSLog.h

+ addAssistant:

增加日志助手

+ (void)addAssistant:(id<IMSLogAssistant> _Nullable)assistant

Parameters

assistant

助手

Discussion

增加日志助手

日志模块提供了将日志分发给日志助手的能力,方便第三方扩展 IMSLog 的功能。 日志助手需遵守 IMSLogAssistant 协议。

Declared In

IMSLog.h

+ log:flag:context:file:function:line:tag:format:

处理单条日志

+ (void)log:(BOOL)asynchronous flag:(IMSLogFlag)flag context:(NSInteger)context file:(const char *_Nullable)file function:(const char *_Nullable)function line:(NSUInteger)line tag:(id _Nullable)tag format:(NSString *_Nullable)format, ...

Discussion

处理单条日志

日志信息包括 flag,level,tag,日志描述,方法名,文件名

Declared In

IMSLog.h

+ loggingQueue

处理日志的队列

+ (dispatch_queue_t _Nullable)loggingQueue

Discussion

处理日志的队列

提供处理日志的当前队列,用于保持线程同步。

Declared In

IMSLog.h

+ tagLevelRules

Tag 和 Level 的映射表

+ (NSArray<IMSLogRule*> *_Nullable)tagLevelRules

Discussion

Tag 和 Level 的映射表

Declared In

IMSLog.h