linux增加 编译选项,4. CMake 系列 - 项目添加编译选项

1. 项目目录结构

test3

├── add

│?? ├── add.c

│?? ├── add.h

│?? └── CMakeLists.txt

├── build

├── CMakeLists.txt

├── config.h.in

├── example

│?? ├── CMakeLists.txt

│?? └── test.c

└── sub

├── CMakeLists.txt

├── sub.c

└── sub.h

很多开源项目都支持编译选项控制编译,用户可以根据编译选项定制需要的功能,典型例子如linux内核,用户可根据自身裁剪内核。

CMake 允许为项目增加编译选项,从而可以根据用户的环境和需求选择最合适的编译方案。

编译选项控制编译的核心思想:通过CMake生成config.h,config.h文件定义一些宏,项目代码包含config.h文件,通过这些宏控制代码模块。

2. 相关代码

2.1 add 模块

add.h

#ifndef _ADD_H

#define _ADD_H

int add(const int a,const int b);

#endif

add.c

#include "add.h"

int add(const int a,const int b)

{

return a+b;

}

CMakeLists.txt

# 递归获取目录下所有的C文件

file(GLOB_RECURSE c_files ./*.c)

# 递归获取目录下所有的h文件

file(GLOB_RECURSE h_files ./*.h)

#生成动态库和静态库

add_library(add_lib_shared SHARED ${c_files})

add_library(add_lib_static STATIC ${c_files})

#将动态库和静态库的名字设置为 add

set_target_properties(add_lib_shared PROPERTIES OUTPUT_NAME "add")

set_target_properties(add_lib_static PROPERTIES OUTPUT_NAME "add")

#设置动态库版本

set_target_properties(add_lib_shared PROPERTIES VERSION 1.0 SOVERSION 1)

#安装动态库和静态库

INSTALL(TARGETS add_lib_shared add_lib_static

LIBRARY DESTINATION lib

ARCHIVE DESTINATION lib)

#安装头文件

INSTALL(FILES ${h_files} DESTINATION include)

2.2 sub 模块

sub.h

#ifndef _SUB_H

#define _SUB_H

int sub(const int a,const int b);

#endif

sub.c

#include "sub.h"

int sub(const int a,const int b)

{

return a - b;

}

CMakeLists.txt

#递归获取目录下所有的C文件

file(GLOB_RECURSE c_files ./*.c)

# 递归获取目录下所有的h文件

file(GLOB_RECURSE h_files ./*.h)

#生成动态库和静态库

add_library(sub_lib_shared SHARED ${c_files})

add_library(sub_lib_static STATIC ${c_files})

#将动态库和静态库的名字设置为 sub

set_target_properties(sub_lib_shared PROPERTIES OUTPUT_NAME "sub")

set_target_properties(sub_lib_static PROPERTIES OUTPUT_NAME "sub")

#设置动态库版本

set_target_properties(sub_lib_shared PROPERTIES VERSION 1.0 SOVERSION 1)

#设置动态库版本

set_target_properties(sub_lib_shared PROPERTIES VERSION 1.0 SOVERSION 1)

#安装动态库和静态库

INSTALL(TARGETS sub_lib_shared sub_lib_static

LIBRARY DESTINATION lib

ARCHIVE DESTINATION lib)

#安装头文件

INSTALL(FILES ${h_files} DESTINATION include)

2.3 example 模块

test.c

#include "config.h"

#ifdef ENABLE_ADD

#include "add.h"

#endif

#ifdef ENABLE_SUB

#include "sub.h"

#endif

#include

int main(int argc,char **argv)

{

int a = 10;

int b = 8;

#ifdef ENABLE_ADD

printf("%d + %d = %d\n",a,b,add(a,b));

#endif

#ifdef ENABLE_SUB

printf("%d - %d = %d\n",sub(a,b));

#endif

return 0;

}

CMakeLists.txt

# 添加头文件路径

include_directories(${PROJECT_SOURCE_DIR}/add)

include_directories(${PROJECT_SOURCE_DIR}/sub)

include_directories(${PROJECT_SOURCE_DIR})

# 添加第三方库(add)头文件路径

link_directories(${PROJECT_SOURCE_DIR}/lib)

# 生成执行文件

add_executable(test_add_sub test.c)

# 链接库文件

if(ENABLE_ADD)

target_link_libraries(test_add_sub add)

endif(ENABLE_ADD)

if(ENABLE_SUB)

target_link_libraries(test_add_sub sub)

endif(ENABLE_SUB)

INSTALL(TARGETS test_add_sub

RUNTIME DESTINATION bin)

2.4 顶层 CMakeLists.txt

CMakeLists.txt

cmake_minimum_required(VERSION 3.10)

# 设置库文件输出目录

set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib)

# 设置执行文件输出目录

set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)

# 添加编译选项

option(ENABLE_ADD "enable add" ON)

option(ENABLE_SUB "enable sub" ON)

if(ENABLE_ADD)

add_subdirectory(add)

endif(ENABLE_ADD)

if(ENABLE_SUB)

add_subdirectory(sub)

endif(ENABLE_SUB)

# 加入一个头文件配置,让cmake对源码进行操作

configure_file(

"${PROJECT_SOURCE_DIR}/config.h.in"

"${PROJECT_SOURCE_DIR}/config.h"

)

add_subdirectory(example)

说明:

configure_file命令用于加入一个配置头文件config.h ,这个文件由CMake从config.h.in生成,通过这样的机制,将可以通过预定义一些参数和变量来控制代码的生成。

option命令添加了ENABLE_ADD 选项

和ENABLE_SUB选项,并且默认值为ON。

cmake 可以根据ENABLE_ADD 选项

和ENABLE_SUB选项的值来控制是否编译add模块和sub模块。

要想在config.h生成对应的宏,需要对config.h.in进行如下配置

config.h.in

#cmakedefine ENABLE_ADD

#cmakedefine ENABLE_SUB

3. 配置&编译

默认配置&编译

$ cd build

$ cmake ..

$ make

$ cd ..

$ tree bin lib

效果如下:

bin

└── test_add_sub

lib

├── libadd.a

├── libadd.so -> libadd.so.1

├── libadd.so.1 -> libadd.so.1.0

├── libadd.so.1.0

├── libsub.a

├── libsub.so -> libsub.so.1

├── libsub.so.1 -> libsub.so.1.0

└── libsub.so.1.0

从生成的lib库,可以看出,add模块和sub模块都生成了。

查看config.h

#define ENABLE_ADD

#define ENABLE_SUB

自定义配置&编译

$ cd build

$ cmake -DENABLE_ADD=OFF ..

$ make

$ cd ..

$ tree bin lib

效果如下:

bin

└── test_add_sub

lib

├── libsub.a

├── libsub.so -> libsub.so.1

├── libsub.so.1 -> libsub.so.1.0

└── libsub.so.1.0

从生成的lib库,可以看出,add模块并未生成了。

查看config.h

/* #undef ENABLE_ADD */

#define ENABLE_SUB

使用ccmake工具进行配置

当我们的项目很大且配置选项很多的时候,可以选择ccmake工具进行配置编译选项,这个是交互式配置工具,有点类似内核的menuconfigure的功能。

20190430235544239679.png

说明:

enter: 编辑选项

c: 配置

g:生成makefile

q:退出

h: 帮助

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值