一、功能宏优点

在进行软件系统的开发过程中,对不同的功能模块的代码使用分别使用与之对应的宏将其控制起来,其有如下优点:

①、方便移植

在移植过程中,可根据功能宏快速的将功能模块代码进行提取和分离。

②、增强可扩展性

可通过宏的开启和关闭来控制此功能开启和关闭,增强了平台的可配置性、可扩展性。

③、快速定位问题

在软件的运行或测试过程中,往往会出现各种问题,如果怀疑某一模块有问题,可将此功能模块关闭,如果问题消失,则说明问题就在此模块,否则可排除此模块。

④、提高开发效率

如果未使用功能宏控制时,如果不要此功能时,则需要对代码进行修改、删除等操作,但之后有需要此功能时,又得重新去修改、增加相应的代码。而一旦有功能宏控制,只需将对应的宏开启或关闭就能达到想要的目的,而不用对代码进行任何的修改。

二、功能宏开关实现

随着平台功能的不断增加,功能宏的数量也随之递增,此时会出现一个困扰设计和开发人员的问题:如何更加有效的管理功能宏?针对这种现象,故提出了功能宏开关模块。顾名思义,功能宏开关模块是通过一个开关(switch)来控制某个宏的开启和关闭,以此达到控制软件平台某个功能的开启和关闭。目前有2种方法实现功能宏开关模块:

①、通过Makefile实现

1. 宏开关设置

// filename: mars_switch.mak
DEBUG_SUPPORT = TRUE

OS_TYPE = AIX

2. 宏的加载

// filename: mars_option.mak
ifeq(TRUE, $(strip $(DEBUG_SUPPORT))
    OPTIONS += __DEBUG__
endif

ifeq(LINUX, $(strip $(OS_TYPE))
    OPTIONS += __LINUX__
else
    ifeq(AIX, $(strip $(OS_TYPE))
        OPTIONS += __AIX__
    else
        ifeq(UNIX, $(strip $(OS_TYPE))
            OPTIONS += __UNIX__
        endif
    endif
endif


3. 宏的编译


// filename: Makefile
CFLAGS += $(patsubst %, -D%, $(OPTIONS))


4. 宏的使用


int main(int argc, const char *argv[])
{
#if defined(__LINUX__)
    fprintf(stdout, "OS is linux!");
#elif defined(__AIX__)
    fprintf(stdout, "OS is aix!");
#elif defined(__UNIX__)
    fprintf(stdout, "OS is unix!");
#endif /*__LINUX__*/
}


②、通过头文件实现

1. 宏值定义

// filename: mars_type.h
#define __ON__            (-1)
#define __OFF__           (-2)
#define __AUTO__          (-3)

#define LINUX             (-1)
#define AIX               (-2)
#define UNIX              (-3)


2. 宏开关设置


// mars_switch.h

#define CFG_DEBUG_SUPPORT  (__ON__)

#define CFG_OS_TYPE        (LINUX)


3. 宏的加载


// filename: mars_features.h

#if defined(CFG_DEBUG_SUPPORT) && (__ON__ == CFG_DEBUG_SUPPORT)
    #define __DEBUG__
#endif

#if defined(CFG_OS_TYPE) && (LINUX == CFG_OS_TYPE)
    #define __LINUX__
#elif defined(CFG_OS_TYPE) && (AIX == CFG_OS_TYPE)
    #define __AIX__
#elif defined(CFG_OS_TYPE) && (UNIX == CFG_OS_TYPE)
    #define __UNIX__
#endif /*CFG_OS_TYPE*/


4. 宏的使用



int main(int argc, const char *argv[])
{
#if defined(__LINUX__)
    fprintf(stdout, "OS is linux!");
#elif defined(__AIX__)
    fprintf(stdout, "OS is aix!");
#elif defined(__UNIX__)
    fprintf(stdout, "OS is unix!");
#endif /*__LINUX__*/
}

三、宏开关的使用

通过以上方法的组织,便可轻松决定某个功能的开启和关闭。例如:

①、关闭__DEBUG__
 1. Makefile:将DEBUG_SUPPORT = FALSE
2. 头文件:将CFG_DEBUG_SUPPORT = __OFF__
②、开启__UNIX__
 1. Makefile:将OS_TYPE = UNIX
 2. 头文件:将CFG_OS_TYPE = UNIX


作者:邹祁峰

2012年11月11日