1. C/C++标准工程目录
├── bin: 编译生成的二进制文件,如可执行文件
├── build: 在build目录中编译,放置cmake生成的中间文件
├── CMakeLists.txt: 编译文件,描述如何编译代码
├── include: 头文件存放路径
├── lib: 库文件存放路径
├── src: 源码存放路径
2. CMake变量
- 变量的引用方式是使用“${}”,在IF中,不需要使用这种方式,直接使用变量名即可。
- 自定义变量使用SET(OBJ_NAME xxxx),使用时${OBJ_NAME}
- cmake的常用变量:
CMAKE_BINARY_DIR, PROJECT_BINARY_DIR :这两个变量内容一致,如果是内部编译,就指的是工程的顶级目录,如果是外部编译,指的就是工程编译发生的目录。
CMAKE_SOURCE_DIR, PROJECT_SOURCE_DIR:这两个变量内容一致,都指的是工程的顶级目录。
CMAKE_CURRENT_BINARY_DIR:外部编译时,指的是target目录,内部编译时,指的是顶级目录
CMAKE_CURRENT_SOURCE_DIR:CMakeList.txt所在的目录
CMAKE_CURRENT_LIST_DIR:CMakeList.txt的完整路径
CMAKE_CURRENT_LIST_LINE:当前所在的行
CMAKE_MODULE_PATH:如果工程复杂,可能需要编写一些cmake模块,这里通过SET指定这个变量
LIBRARY_OUTPUT_DIR, BINARY_OUTPUT_DIR:库和可执行的最终存放目录
PROJECT_NAME:当前CMakeList.txt里设置的project_name
CMAKE_PROJECT_NAME:整个项目配置的project_name
- 其他内置变量
BUILD_SHARED_LIBS: 设置ADD_LIBRARY语句默认的值
CMAKE_C_FLAGS: 设置编译C语言的编译工具
CMAKE_CXX_FLAGS: 设置编译C++语言的编译工具
- 设置DEBUG或RELEASE
在工程build目录下执行 cmake .. -DCMAKE_BUILD_TYPE=DEBUG|RELEASE,再执行make
或者在顶级CMakeList.txt里加入: set(CMAKE_BUILD_TYPE Debug|Release|MinSizeRel|RelWithDebInfo)
3. CMake常用语句
message("PROJECT_SOURCE_DIR = ${PROJECT_SOURCE_DIR}")命令:打印变量的值
include_directories(dir1 dir2 … )命令:指定build时需要的头文件路径,相当于编译时的-Idir1
aux_source_directory(dir VAR)命令:发现一个目录下所有的源代码文件并将列表存储在一个变量中
link_directories(dir1 dir2 … )命令:指定build时需要的库文件路径,相当于编译时的-Ldir1
target_link_libraries(target lib1 lib2 …)命令:为target添加需要链接的库,相当于编译时的-llib1
add_library(libname [SHARED | STATIC] SRC_LIST)命令:生成动态库或静态库,STATIC静态库,SHARED动态库
add_subdirectory(source_dir )命令:添加一个子目录并构建该子目录
add_executable(<name> [WIN32] [MACOSX_BUNDLE][EXCLUDE_FROM_ALL][source1] [source2 ...])命令:添加一个可执行目标source1为代码源文件
set(VAR [VALUE])命令:定义变量(可以给变量赋多个VALUE,如set(SRC_LIST main.c util.c reactor.c))或者给变量赋值
4.示例
# cmake最小版本2.8
cmake_minimum_required (VERSION 2.8)
# 工程名
project (my_test_bin)
# 设置交叉编译工具链地址
set (TOOLCHAIN_DIR "/home/toolchain-mipsel_24kec+dsp_gcc-4.8-linaro_uClibc-0.9.33.2")
set (CMAKE_CXX_COMPILER ${TOOLCHAIN_DIR}/bin/mipsel-openwrt-linux-uclibc-g++)
set (CMAKE_C_COMPILER ${TOOLCHAIN_DIR}/bin/mipsel-openwrt-linux-uclibc-gcc)
# 设置优化编译
# 使用debug:cmake -B. -H.. -DCMAKE_BUILD_TYPE=Debug
# 使用release:cmake -B. -H.. -DCMAKE_BUILD_TYPE=Release
set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -O0")
set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} -O3")
# 设置支持C++ 11
set (CMAKE_CXX_STANDARD 11)
set (CMAKE_CXX_STANDARD_REQUIRED ON)
add_definitions (-D_GLIBCXX_USE_C99=1)
# 设置生成的可执行文件路径
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)
# 添加头文件路径
include_directories (
${PROJECT_SOURCE_DIR}/include/database/sqlite3
)
# 添加库路径
link_directories (
${PROJECT_SOURCE_DIR}/lib
)
# 生成可执行文件
add_executable (
my_test_bin
src/database/sqlite3/sqlite3_management.cpp
src/main.cpp
)
# 链接库
target_link_libraries (
my_test_bin
sqlite3
)
注意语句的顺序,顺序掉乱可能导致语句不生效的问题。
4. 执行
cd build
cmake -B. -H..
make
cmake命令:
-B. :指定build生成的路径为当前路径
-H…:指定CMakeLists.txt的路径在上一层目录
最后生成的可执行文件存放在bin路径下,复制到开发板,./运行即可
如果使用debug或release版本
cmake -B. -H.. -DCMAKE_BUILD_TYPE=Debug
cmake -B. -H.. -DCMAKE_BUILD_TYPE=Release