Step 3: Adding Usage Requirements for a Library

1添加库的使用规范

2具体脚本

2.1target_compile_definitions()

向工程中加入预处理定义

语法:

target_compile_definitions(
<INTERFACE|PUBLIC|PRIVATE> [items1...]
[<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])

  • cmake --build . --config release : 可以生成release版本,默认为debug版本

举例

cmake_minimum_required(VERSION 3.15)

project ( hello_world_prj )

set( EXE_SOURCES
src/main.cpp
src/Hello.cpp
)

add_executable( hello_world_exe ${EXE_SOURCES} )

target_include_directories( hello_world_exe
PRIVATE
${PROJECT_SOURCE_DIR}/include
)

target_compile_definitions( hello_world_exe PRIVATE MY_DEF1 )
target_compile_definitions( hello_world_exe PRIVATE MY_DEF2 )
target_compile_definitions( hello_world_exe PRIVATE MY_DEF3 )
target_compile_definitions( hello_world_exe
PRIVATE
MY_DEF4
MY_DEF5
MY_DEF6
)

到此,向工程hello_world_prj中添加了如上的预处理

add_executable( hello_world_exe_1024 ${EXE_SOURCES} )

target_include_directories( hello_world_exe_1024
PRIVATE
${PROJECT_SOURCE_DIR}/include
)

target_compile_definitions( hello_world_exe_1024 PRIVATE HELLO_DEF1 )
target_compile_definitions( hello_world_exe_1024 PRIVATE HELLO_DEF2 )

到此,向工程hello_world_exe_1024中添加了如上的预处理

参考
参考

2.2 target_compile_options()

向工程中添加编译选项,target目标文件必须已经存在啦

Adds options to the COMPILE_OPTIONS or INTERFACE_COMPILE_OPTIONS target properties. These options are used when compiling the given , which must have been created by a command such as add_executable() or add_library() and must not be an ALIAS target.

在编译给定目标文件时,指定要用到的编译选项。target目标文件必须已经存在(由命令add_executable()或add_library()创建)且不能被IMPORTED修饰。

语法

target_compile_options( [BEFORE]
<INTERFACE|PUBLIC|PRIVATE> [items1...]
[<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])

举例1

在cmake脚本中,设置编译选项可以通过add_compile_options命令,也可以通过set命令修改CMAKE_CXX_FLAGSCMAKE_C_FLAGS
使用这两种方式在有的情况下效果是一样的,但请注意它们还是有区别的:
add_compile_options命令添加的编译选项是针对所有编译器的(包括c和c++编译器),而set命令设置CMAKE_C_FLAGSCMAKE_CXX_FLAGS变量则是分别只针对c和c++编译器的。

判断编译器类型,如果是gcc编译器,则在编译选项中加入c++11支持

if(CMAKE_COMPILER_IS_GNUCXX)
add_compile_options(-std=c++11)
message(STATUS "optional:-std=c++11")
endif(CMAKE_COMPILER_IS_GNUCXX)

使用add_compile_options添加-std=c++11选项,是想在编译c++代码时加上c++11支持选项。但是因为add_compile_options是针对所有类型编译器的,所以在编译c代码时,就会产生如下warning,消除的方法为:

判断编译器类型,如果是gcc编译器,则在编译选项中加入c++11支持,在Linux可以跑通

if(CMAKE_COMPILER_IS_GNUCXX)
set(CMAKE_CXX_FLAGS "-std=c++11 ${CMAKE_CXX_FLAGS}")
message(STATUS "optional:-std=c++11")
endif(CMAKE_COMPILER_IS_GNUCXX)

参考1

举例2

cmake_minimum_required ( VERSION 3.15 )

project ( COMPILE_OPTIONS_PRJ CXX )

set ( PRJ_SRC_LIST )
set ( PRJ_HEADER_LIST )
set ( PRJ_LIBRARIES )
set ( PRJ_INCLUDE_DIRS )

file ( GLOB root_header_files "${CMAKE_CURRENT_SOURCE_DIR}/.h" )
file ( GLOB root_src_files "${CMAKE_CURRENT_SOURCE_DIR}/
.cpp" )

list ( APPEND PRJ_HEADER_LIST ${root_header_files} )
list ( APPEND PRJ_SRC_LIST ${root_src_files} )

add_executable ( ${PROJECT_NAME} ${PRJ_SRC_LIST} ${PRJ_HEADER_LIST} )

target_include_directories ( ${PROJECT_NAME}
PRIVATE
${PRJ_INCLUDE_DIRS}
)

target_compile_options ( ${PROJECT_NAME}
PRIVATE
-MY_OP1
)

target_compile_options ( ${PROJECT_NAME}
PRIVATE
-MY_OP2
)

target_compile_options ( ${PROJECT_NAME}
PRIVATE
-MY_OP3
)

get_target_property ( MY_COMPILE_OPTIONS ${PROJECT_NAME} COMPILE_OPTIONS )

message ( STATUS "MY_COMPILE_OPTIONS = ${MY_COMPILE_OPTIONS}" )

target_compile_features ( ${PROJECT_NAME}
PUBLIC
cxx_std_14
)

target_link_libraries ( ${PROJECT_NAME}
PRIVATE
${PRJ_LIBRARIES}
)

参考2

2.3 target_include_directories()

举例

cmake_minimum_required(VERSION 3.10)

递归获取目录下所有的.cxx文件

file(GLOB_RECURSE cpp_files ./*.cxx)

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

file(GLOB_RECURSE h_files ./*.h)

project(MathFunctions)

add_library(MathFunctions mysqrt.cxx)

添加该脚本之后,主CMakeLists.txt就可以不包含该库的头文件啦

因为使用该库(MathFunctions)的用户,可以使用该库所在文件的

所以,使用INTERFACE接口

子库自己已经指明,若调用该子库,就可以使用该子库的头文件

这个方法好啊

target_include_directories(MathFunctions INTERFACE
${CMAKE_CURRENT_SOURCE_DIR})

详见 Step1

2.5 target_compile_features

Add expected compiler features to a target. 如cxx_std_14(就是添加C++14的编译特征,可以对C++14进行编译)

语法

target_compile_features( <PRIVATE|PUBLIC|INTERFACE> [...])

参考

最佳实践:参考#2.2中的举例2

Q:在ubuntu系统下,使用cmake编译jsoncpp的时候,执行cmake后,出现错误,关键信息为:target_compile_features specified unknown feature cxx_std_11 for target...

A:cmake版本太低,找不到cxx_std_11等相关宏的定义。解决方法:升级cmake版本到最新版。

3参考

参考

参考

posted @ 2022-02-10 14:20  绍荣  阅读(172)  评论(0)    收藏  举报