根据Debug和Release状态的变化来屏蔽日志输出

CINNS 2012-02-06

我们平时在开发应用的时候,经常会用到 NSLog 来调试我们的程序,而随着项目越来越大,这些用于调试的日志输出就会变得很难管理。 发布正式版的时候一定要屏蔽掉所有后台输出,因为这些输出还是比较消耗系统资源的。  往往到了这个时候,我们不得不去一行一行的找到 NSLog 调用,然后注释掉。 这样做在项目小的时候还比较有效,但随着项目规模的增长,就会变得越来越难控制。  下面就给大家介绍一个简单的方法,让我们在生成 Release 版本时不需要进行任何更改即可屏蔽所有的 Log 输出。

    首先我们先要定义这样一段预处理命令,文件名随便起,例如 CLog.h

    #ifdef DEBUG

#defineCLog(format,...)NSLog(format,##__VA_ARGS__)

#else

#defineCLog(format,...)

    #endif

    这里我们判断 DEBUG 这个宏是否定义,如果有定义我们就将这个 CLog 宏替换成 NSLog 调用,而如果没有定义过 DEBUG 标志我们就直接跳过。这点应该不难理解。

    检查 DEBUG 标志是否正确定义,Xcode 一般会在 debug 运行配置项里面已经定义号了DEBUG 标志,如果没定义我们就自己写上,以我的 Xcode 4 为例,如下图:

根据Debug和Release状态的变化来屏蔽日志输出

    找到 PreProcessor Macros 这个属性,对于 Debug 配置我们给他写上 DEBUG,而在 Release 配置中把它留空。 这样我们刚才那段预处理命令就可以根据这个标志来判断我们编译的时调试版本还是发布版本,从而控制 NSLog 的输出。 (因为 Xcode 4 会把 debug/release 两个配置项同时对比展现出来,而 3.x 版本的只能分别设置,如果你用的时xcode 3.x 开发工具, 那么就分别对 Debug/Release 都检查一下)。

    到了这里我们这个判断工作就都进行完了,不过这里还有一点比较麻烦,就是我们如果想实用 CLog 宏,就必须要导入 CLog.h 这个头文件。 不过 Xcode 为我们提供了一种非常巧妙的解决办法。 我们自己看一下项目里的文件,是不是有一个叫做 xxx-prefix.pch 的文件,只要注意到 pch 这个扩展名就可以了。 这个文件是做什么用的呢? 下面是一个 pch 文件的样本:

    //

//Prefixheaderforallsourcefiles

//

#import<Availability.h>

#ifndef__IPHONE_3_0

#warning"ThisprojectusesfeaturesonlyavailableiniPhoneSDK3.0andlater."

#endif

#ifdef__OBJC__

#import<UIKit/UIKit.h>

#import<Foundation/Foundation.h>

    #endif

    这里引入了一些头文件, 其实是 Xcode 的一种预编译机制,我们在编译一个项目的时候,会有很多常用的源文件,并且这些代码文件几乎不被修改,所以 Xcode 对这些文件只在早期进行一次编译,以便我们以后的多次构建过程中反复实用。 例如这里的 UIKit 和 Foundation ,这样的机制可以加快我们每次构建项目的速度。 当然这里我们不必太深究它,知道它的作用后,我们就可以利用它来为我们的开发提供便利。 我们只需要将刚刚建立的 CLog.h 也在这里面引入一下,这样我们项目中的所有文件就都能够访问到我们刚刚定义的 CLog 宏了。 下面是完成后的 pch 文件:

    #import <Availability.h>

#ifndef__IPHONE_3_0

#warning"ThisprojectusesfeaturesonlyavailableiniPhoneSDK3.0andlater."

#endif

#ifdef__OBJC__

#import<UIKit/UIKit.h>

#import<Foundation/Foundation.h>

#import"CLog.h"

    #endif

    这样,我们的 CLog 就完成了,现在可以在任何一个源文件中实用 CLog 宏来输出日志,预处理命令会自动判断当前的编译配置,如果是 Debug,就会输出日志,反之则什么都不会输出。

相关推荐

APCDE / 0评论 2019-12-01
野生的世界 / 0评论 2015-10-29