优化系统Log

只在DEBUG模式下才打印Log (不改变系统的Log内容)

hannah-morgan-91151.jpg

作用:

只在DEBUG模式下才打印Log,可以减少在应用打包上线后,后台打印造成的性能浪费。OPTIMIZE是release默认会加的宏。

在工程的 .pch文件中加入如下代码:

#ifndef __OPTIMIZE__

  #define NSLog(format, ...)  do {(NSLog)((format) , ##__VA_ARGS__)} while (0)

  #else

      #define NSLog(format, ...) do{} while(0)

  #endif

也可以采用这种方式:

#ifdef DEBUG
    #define NSLog(format, ...)  (NSLog)((format) , ##__VA_ARGS__)
 #else
    #define NSLog(format, ...) do{} while(0)
#endif

如果采用这种方式需要注意,必须在 "Target > Build Settings > Preprocessor Macros > Debug" 里设置"DEBUG=1"。(因为有的情况下,这个设置为空,需手动设置。如Unity3D生成的Xcode代码默认就没有设置)

对NSLog原生行为的改进,Log出文件位置,所在文件的代码行,方法名

#define NSLog(format, ...)    do {                                                                          \
                             fprintf(stderr, "<%s : %d> %s\n",                                           \
                             [[[NSString stringWithUTF8String:__FILE__] lastPathComponent] UTF8String],  \
                             __LINE__, __func__);                                                        \
                             (NSLog)((format), ##__VA_ARGS__);                                           \
                             fprintf(stderr, "-------\n");                                               \
                           } while (0)

合并以上两个功能(只在debug模式打印,同时改变系统log的行为)

#ifdef DEBUG
    #define NSLog(format, ...)  do {                                                                          \
                             fprintf(stderr, "<%s : %d> %s\n",                                           \
                             [[[NSString stringWithUTF8String:__FILE__] lastPathComponent] UTF8String],  \
                             __LINE__, __func__);                                                        \
                             (NSLog)((format), ##__VA_ARGS__);                                           \
                             fprintf(stderr, "-------\n");                                               \
                           } while (0)
 #else
    #define NSLog(format, ...) do{} while(0)
#endif
 预定义宏的行为是由编译器指定的。
__FILE__返回当前文件的绝对路径,
__LINE__返回展开该宏时在文件中的行数,
__func__是改宏所在scope的函数名称,
__VA_ARGS__表示的是宏定义中的...中的所有剩余参数,
##将前面的格式化字符串和后面的参数列表合并。
##除了拼接前后文本之外,还有一个功能,那就是如果后方文本为空,那么它会将前面一个逗号吃掉。这个特性当且仅当上面说的条件成立时才会生效,因此可以说是特例。加上这条规则后,我们就可以将刚才的式子展开为正确的(NSLog)((@"Hello"));了。
#单个井号的作用是字符串化,简单来说就是将替换后在两头加上“”

第二个参数是...,在宏定义(其实也包括函数定义)的时候,写为...的参数被叫做可变参数(variadic)。这里第一个格式化字符串即对应宏里的format,后面的变量全部映射为...作为整体处理。

使用do..while的原因:
这个吃掉分号的方法被大量运用在代码块宏中,几乎已经成为了标准写法。而且while(0)的好处在于,在编译的时候,编译器基本都会为你做好优化,把这部分内容去掉,最终编译的结果不会因为这个do while而导致运行效率上的差异。

参考文章

iOS开发:NSLog使用技巧

宏定义的黑魔法 - 宏菜鸟起飞手册

以下宏定义的内容是摘自宏定义的黑魔法 - 宏菜鸟起飞手册

C中的宏分为两类,对象宏(object-like macro)和函数宏(function-like macro)。

连着的井号##在宏中是一个特殊符号,它表示将两个参数连接起来这种运算。

__COUNTER__是一个预定义的宏,这个值在编译过程中将从0开始计数,每次被调用时加1。因为唯一性,所以很多时候被用来构造独立的变量名称。

MIN(a,b)的最佳实现


#define __NSX_PASTE__(A,B)     A##B

#define MIN(A,B)     __NSMIN_IMPL__(A,B,__COUNTER__)

#define __NSMIN_IMPL__(A,B,L)    ({
                             __typeof__(A) __NSX_PASTE__(__a,L) = (A); \
                             __typeof__(B) __NSX_PASTE__(__b,L) = (B); \
                                 (__NSX_PASTE__(__a,L) < __NSX_PASTE__(__b,L)) ? __NSX_PASTE__(__a,L) : __NSX_PASTE__(__b,L); \
                              })

优雅,高效NSLog宏定义:

//A better version of NSLog
#define NSLog(format, ...) do {                                                                          \
                             fprintf(stderr, "<%s : %d> %s\n",                                           \
                             [[[NSString stringWithUTF8String:__FILE__] lastPathComponent] UTF8String],  \
                             __LINE__, __func__);                                                        \
                             (NSLog)((format), ##__VA_ARGS__);                                           \
                             fprintf(stderr, "-------\n");                                               \
                           } while (0)
预定义宏的行为是由编译器指定的。
__FILE__返回当前文件的绝对路径,
__LINE__返回展开该宏时在文件中的行数,
__func__是改宏所在scope的函数名称,
__VA_ARGS__表示的是宏定义中的...中的所有剩余参数,
##将前面的格式化字符串和后面的参数列表合并。
##除了拼接前后文本之外,还有一个功能,那就是如果后方文本为空,那么它会将前面一个逗号吃掉。这个特性当且仅当上面说的条件成立时才会生效,因此可以说是特例。加上这条规则后,我们就可以将刚才的式子展开为正确的(NSLog)((@"Hello"));了。
#单个井号的作用是字符串化,简单来说就是将替换后在两头加上“”

第二个参数是...,在宏定义(其实也包括函数定义)的时候,写为...的参数被叫做可变参数(variadic)。这里第一个格式化字符串即对应宏里的format,后面的变量全部映射为...作为整体处理。

使用do..while的原因:
这个吃掉分号的方法被大量运用在代码块宏中,几乎已经成为了标准写法。而且while(0)的好处在于,在编译的时候,编译器基本都会为你做好优化,把这部分内容去掉,最终编译的结果不会因为这个do while而导致运行效率上的差异。

示例:

if (errorHappend)
    NSLog(@"Oops, error happened");
else
  //Yep, no error, I am happy~ :)

宏替换后:

if (errorHappend) {
    fprintf((stderr, "<%s : %d> %s\n",[[[NSString stringWithUTF8String:__FILE__] lastPathComponent] UTF8String], __LINE__, __func__);
    (NSLog)((format), ##__VA_ARGS__);
    fprintf(stderr, "-------\n");
}; else {
    //Yep, no error, I am happy~ :)
}

可以发现多出来一个分号,此时会编译不通过。

你可能感兴趣的:(优化系统Log)