CMake 学习(持续更新......)

CMakeLists.txt里添加宏开关

比如添加打印log的宏LOG,代码如下

option(DEFINE__LOG__ "print log" ON)
if(DEFINE__LOG__)
    add_definitions(-D__LOG__)
endif(DEFINE__LOG__)

但在源码里面不能有

#define __LOG__

这样就可以在cmake的时候开关这个宏了

cmake -D__LOG__=ON ..

CMakeLists.txt 添加依赖项

  1. 如果添加的依赖项只有头文件,那么就比较简单,设定头文件路径,添加即可。设定头文件路径有两种方式,如果可以通过find_package添加最好,如果不行,就用set设定目录,如下:
find_package(Eigen3 REQUIRED)
include_directories(${EIGEN3_INCLUDE_DIR})

或者

set(EIGEN3_INCLUDE_DIR ${FaceRecon_3RDPARTY_DIR}/eigen)
include_directories(${EIGEN3_INCLUDE_DIR})
  1. 如果添加的依赖项有对应的链接库,那么除了添加头文件,还需要将链接库添加进去
find_package(OpenCV 3.4.3 REQUIRED)
include_directories(${OpenCV_INCLUDE_DIRS})
target_link_libraries(${PROJECT_NAME} ${OpenCV_LIBS})

如果添加的依赖库是自己生成的,直接添加名字就行,比如添加hello库

target_link_libraries(${PROJECT_NAME} hello)

如果是自己生成的依赖库有很多,可放在lib目录下,通过如下命令添加,这里只针对windows

FILE(GLOB suitesparse_libs "${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/suitesparse/lib64/*.lib")
target_link_libraries(hello ${suitesparse_libs})
  1. 如果依赖项需要自己编译对应依赖库,那么需要包含依赖项代码,并为其编写对应CMakeLists.txt
    例如,对应项目目录如下:
demo
    CMakeLists.txt
    -include
    -src
    -thirdparty
        -hello
            -include
            -src
            CMakeLists.txt
        -eigen
        CMakeLists.txt

我们有自己编译hello依赖项,其中在demo目录下的CMakeLists.txt里添加子目录

add_subdirectory(thirdparty)

在thirdparty目录下的CMakeLists.txt里添加子目录

add_subdirectory(hello)

其中hello里的CMakeLists.txt只需要将平时生成可执行文件的语句

add_executable(${PROJECT_NAME}  ${SOURCE_FILES} ${HEADER_FILES})

替换成

add_library(${PROJECT_NAME} STATIC ${SOURCE_FILES} ${HEADER_FILES})

这里 STATIC 表示是生成静态库

CMake aux_source_directory

让CMake找到源文件

aux_source_directory(src SOURCE_FILES)
add_executable(demo ${SOURCE_FILES})

把当前路径下的src目录下的所有源文件放到变量
SOURCE_FILES中

CMake FILE

FILE语句功能强大,可以读、写、文件系统等,具体可参考cmake官方网站

FILE(GLOB SOURCE_FILES ${CMAKE_CURRENT_SOURCE_DIR}/src/*.cpp ${CMAKE_CURRENT_SOURCE_DIR}/src/hello/*.cpp)
FILE(GLOB HEADER_FILES ${CMAKE_CURRENT_SOURCE_DIR}/include/*.h* ${CMAKE_CURRENT_SOURCE_DIR}/include/hello/*.h*)

文件系统的作用

set_target_properties

该命令一般用在导入第三方动态库的时候,比如:

set_target_properties(lib_opencv
    PROPERTIES
    IMPORTED_LOCATION ${CMAKE_CURRENT_SOURCE_DIR}/../jniLibs/${ANDROID_ABI}/libopencv_java3.so
    )

该命令语法如下:

set_target_properties(target1 target2 ...
                      PROPERTIES prop1 value1
                      prop2 value2 ...)

设置target的PROPERTIES,上述例子中,我们设置了opencv动态库的路径。

install

Specify rules to run at install time.
也就是在运行install的时候才会运行的语句

install(TARGETS targets... [EXPORT <export-name>]
    [[ARCHIVE|LIBRARY|RUNTIME|OBJECTS|FRAMEWORK|BUNDLE|
      PRIVATE_HEADER|PUBLIC_HEADER|RESOURCE]
     [DESTINATION <dir>]
     [PERMISSIONS permissions...]
     [CONFIGURATIONS [Debug|Release|...]]
     [COMPONENT <component>]
     [NAMELINK_COMPONENT <component>]
     [OPTIONAL] [EXCLUDE_FROM_ALL]
     [NAMELINK_ONLY|NAMELINK_SKIP]
    ] [...]
    [INCLUDES DESTINATION [<dir> ...]]
    )

可以将lib,framework,dll ,header等install到固定位置

debug , release

set(CMAKE_RELEASE_POSTFIX "")
set(CMAKE_DEBUG_POSTFIX "-debug")

可以通过debug还是release 生成对应版本库,在链接该库的时候:

target_link_libraries(LandmarkTracker PUBLIC debug ${ncnn_LIB_DEBUG} optimized ${ncnn_LIB_RELEASE})