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