在ios iphone编程中使用封装的NSLog来打印调试信息

使用NSLog的一个风险是：它的运行会占用时间和设备资源。

简单而粗暴的解决方案是：在release前，将所有的NSLog注释掉。简单有效，但副作用是：下次你要调试时，又得将NSLog一个个取消注释。

以release模式编译的程序不会用NSLog输出，而以debug模式编译的程序将执行NSLog的全部功能。

解决步骤：

1. 修改<AppName>-Prefix.pch ，增加以下的宏代码
   [cpp]  view plain copy

   1. #ifdef DEBUG  
   2. # define DLog(fmt, ...) NSLog((@"[文件名:%s]\n" "[函数名:%s]\n" "[行号:%d] \n" fmt), __FILE__, __FUNCTION__, __LINE__, ##__VA_ARGS__);  
   3. #else  
   4. # define DLog(...);  
   5. #endif  
2. 在程序中使用DLog来替换原来的NSLog
   [cpp]  view plain copy

   1. DLog(@"当前程序目录是：%@", [self applicationDocumentsDirectory ]);  
   
   
3. 修改项目的配置，使得在debug编译的时候，编译DLog的宏，产生详细的日志信息，而release的时候，不产生任何控制台输出
   在Other Linker Flags 中，在debug的时候，加入编译属性 -DEBUG
   
4. 这样控制台会显示这样的日志信息
   [cpp]  view plain copy

   1. 2011-12-27 22:23:53.303 IManager[5449:b603] [文件名:/Users/roamer/Project/ÂõΩÊ≥∞ÂêõÂÆâ/Ëꕉ∏öÈÉ®ÁÆ°ÁêÜiphone/IManager/IManager/AppDelegate.m]  
   2. [函数名:-[AppDelegate application:didFinishLaunchingWithOptions:]]  
   3. [行号:37]   
   4. 当前程序目录是：/Users/roamer/Library/Application Support/iPhone Simulator/4.3.2/Applications/6B0E7B08-5528-468A-B728-0C4580805368/Documents  
   
   

   补充：

   　　1) __VA_ARGS__ 是一个可变参数的宏，很少人知道这个宏，这个可变参数的宏是新的C99规范中新增的，目前似乎只有gcc支持（VC6.0的编译器不支持）。宏前面加上##的作用在于，当可变参数的个数为0时，这里的##起到把前面多余的","去掉的作用,否则会编译出错, 你可以试试。
   　　2) __FILE__ 宏在预编译时会替换成当前的源文件名
   　　3) __LINE__宏在预编译时会替换成当前的行号
   　　4) __FUNCTION__宏在预编译时会替换成当前的函数名称

在Objective-c开发程序的时候，有专门的日志操作类NSLog，它将指定的输出，输出到（stderr）,我们可以利用Xcode的日志输出窗口，那么既然是要记录到具体日志文件，我们就想输出日志写入到具体的日志文件即可。
 
代码
1、  宏定义（下面是我在程序中常用到的日志宏，用DEBUG开关管理，
也就是说只有在DEBUG模式下才让日志输出 ：）
 
#ifdef DEBUG 
#  define LOG(fmt, ...) do {                                            / 
        NSString* file = [[NSString alloc] initWithFormat:@"%s", __FILE__]; / 
        NSLog((@"%@(%d) " fmt), [file lastPathComponent], __LINE__, ##__VA_ARGS__); / 
        [file release];                                                 / 
    } while(0) 
#  define LOG_METHOD NSLog(@"%s", __func__) 
#  define LOG_CMETHOD NSLog(@"%@/%@", NSStringFromClass([self class]), NSStringFromSelector(_cmd)) 
#  define COUNT(p) NSLog(@"%s(%d): count = %d/n", __func__, __LINE__, [p retainCount]); 
#  define LOG_TRACE(x) do {printf x; putchar('/n'); fflush(stdout);} while (0) 
#else 
#  define LOG(...) 
#  define LOG_METHOD 
#  define LOG_CMETHOD 
#  define COUNT(p) 
#  define LOG_TRACE(x) 
#endif
 
可以看到，除了标准的用户定义输出外，我还加入了许多有用的信息，
比如源程序文件位置，行号，类名，函数名等。具体的应用可以在具体的开发过程中添加、删除。
 
2、  应用：
- (void)redirectNSLogToDocumentFolder{ 
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,NSUserDomainMask, YES); 
    NSString *documentsDirectory = [paths objectAtIndex:0]; 
    NSString *fileName =[NSString stringWithFormat:@"%@.log",[NSDate date]]; 
    NSString *logFilePath = [documentsDirectory stringByAppendingPathComponent:fileName]; 
    freopen([logFilePath cStringUsingEncoding:NSASCIIStringEncoding],"a+",stderr); 
} 
 
- (void)applicationDidFinishLaunching:(UIApplication *)application { 
    // 真机测试时保存日志 
    if ([CDeviceInfo getModelType] != SIMULATOR) { 
        [self redirectNSLogToDocumentFolder]; 
} 
}
 
真机测试的时候，可以利用freopen将标准错误输出保存到指定的文件当中，
这样就可以在问题发生后分析日志文件。
 
3、  设置DEBUG标志是否正确定义
 
Xcode 一般会在 debug 运行配置项里面已经定义号了DEBUG 标志，如果没定义我们就自己写上，以我的 Xcode 4 为例，在项目get Info中找到 PreProcessor Macros 这个属性，对于 Debug 配置我们给他写上 DEBUG，而在 Release 配置中把它留空。 这样我们刚才那段预处理命令就可以根据这个标志来判断我们编译的时调试版本还是发布版本，从而控制 NSLog 的输出。 (因为 Xcode 4 会把 debug/release 两个配置项同时对比展现出来，而 3.x 版本的只能分别设置，如果你用的时xcode 3.x 开发工具， 那么就分别对 Debug/Release 都检查一下)。

在Objective-c开发程序的时候，有专门的日志操作类NSLog，它将指定的输出，输出到（stderr）,我们可以利用Xcode的日志输出窗口，那么既然是要记录到具体日志文件，我们就想输出日志写入到具体的日志文件即可。
 
代码
1、  宏定义（下面是我在程序中常用到的日志宏，用DEBUG开关管理，
也就是说只有在DEBUG模式下才让日志输出 ：）
 
#ifdef DEBUG 
#  define LOG(fmt, ...) do {                                            / 
        NSString* file = [[NSString alloc] initWithFormat:@"%s", __FILE__]; / 
        NSLog((@"%@(%d) " fmt), [file lastPathComponent], __LINE__, ##__VA_ARGS__); / 
        [file release];                                                 / 
    } while(0) 
#  define LOG_METHOD NSLog(@"%s", __func__) 
#  define LOG_CMETHOD NSLog(@"%@/%@", NSStringFromClass([self class]), NSStringFromSelector(_cmd)) 
#  define COUNT(p) NSLog(@"%s(%d): count = %d/n", __func__, __LINE__, [p retainCount]); 
#  define LOG_TRACE(x) do {printf x; putchar('/n'); fflush(stdout);} while (0) 
#else 
#  define LOG(...) 
#  define LOG_METHOD 
#  define LOG_CMETHOD 
#  define COUNT(p) 
#  define LOG_TRACE(x) 
#endif
 
可以看到，除了标准的用户定义输出外，我还加入了许多有用的信息，
比如源程序文件位置，行号，类名，函数名等。具体的应用可以在具体的开发过程中添加、删除。
 
2、  应用：
- (void)redirectNSLogToDocumentFolder{ 
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,NSUserDomainMask, YES); 
    NSString *documentsDirectory = [paths objectAtIndex:0]; 
    NSString *fileName =[NSString stringWithFormat:@"%@.log",[NSDate date]]; 
    NSString *logFilePath = [documentsDirectory stringByAppendingPathComponent:fileName]; 
    freopen([logFilePath cStringUsingEncoding:NSASCIIStringEncoding],"a+",stderr); 
} 
 
- (void)applicationDidFinishLaunching:(UIApplication *)application { 
    // 真机测试时保存日志 
    if ([CDeviceInfo getModelType] != SIMULATOR) { 
        [self redirectNSLogToDocumentFolder]; 
} 
}
 
真机测试的时候，可以利用freopen将标准错误输出保存到指定的文件当中，
这样就可以在问题发生后分析日志文件。
 
3、  设置DEBUG标志是否正确定义
 
Xcode 一般会在 debug 运行配置项里面已经定义号了DEBUG 标志，如果没定义我们就自己写上，以我的 Xcode 4 为例，在项目get Info中找到 PreProcessor Macros 这个属性，对于 Debug 配置我们给他写上 DEBUG，而在 Release 配置中把它留空。 这样我们刚才那段预处理命令就可以根据这个标志来判断我们编译的时调试版本还是发布版本，从而控制 NSLog 的输出。 (因为 Xcode 4 会把 debug/release 两个配置项同时对比展现出来，而 3.x 版本的只能分别设置，如果你用的时xcode 3.x 开发工具， 那么就分别对 Debug/Release 都检查一下)。