【CMake系列】06-项目结构与输出路径管理

为了对大型项目实现更好的管理【模块化协作开发等等】，cmake 提供了很多指令，可以对项目的结构进行调整、管理，便于项目的合理规划。本文我们要学习的就是项目结构的设置，以及构建程序等输出路径的设置

本专栏的实践代码全部放在 github 上，欢迎 star !!!

如有问题，欢迎留言、或加群【392784757】交流

涉及命令/变量

source_group

对文件进行分组，vs实现方式就是创建filter

source_group(<name> [FILES <src>...] [REGULAR_EXPRESSION <regex>])

source_group(TREE <root> [PREFIX <prefix>] [FILES <src>...])

name group名称

FILES 需要管理的文件，

REGULAR_EXPRESSION 支持正则表达式

TREE 在目录下设置管理

add_subdirectory

实现代码结构分层，有利于模块化开发

在顶层CMakeListst.txt 使用这个命令，对代码结构进行分层管理

add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL] [SYSTEM])

source_group 和 add_subdirectory 二者区别

source_group 的实现，通过添加Filter实现，在本地并未创建新的文件夹【仅在 windows vs 】

add_subdirectory 是对本地已经创建的文件夹进行管理，实现代码分层、模块化

路径变量

CMAKE_PREFIX_PATH #安装路径 可以预设也可以 -D 传递

CMAKE_SOURCE_DIR = PROJECT_SOURCE_DIR # 顶层CMakeLists.txt 所在路径

CMAKE_BINARY_DIR = PROJECT_BINARY_DIR

#

CMAKE_LIBRARY_OUTPUT_DIRECTORY

CMAKE_RUNTIME_OUTPUT_DIRECTORY

CMAKE_ARCHIVE_OUTPUT_DIRECTORY

# 以下三个 需要使用 include(GNUInstallDirs) 才能使用

CMAKE_INSTALL_LIBDIR

CMAKE_INSTALL_BINDIR

CMAKE_INSTALL_INCLUDEDIR # 头文件

CMAKE_CURRENT_SOURCE_DIR

CMAKE_CURRENT_BINARY_DIR

CMAKE_CURRENT_LIST_DIR # 当前cmakelists.txt文件所在路径

EXECUTABLE_OUTPUT_PATH # 库和可执行的最终存放目录

LIBRARY_OUTPUT_PATH

$ENV{} # 调用环境变量

set(ENV{变量名} 值) #设置环境变量

CMAKE_CURRENT_LIST_FILE # 输出调用这个变量的 CMakeLists.txt 的完整路径

CMAKE_CURRENT_LIST_LINE # 输出这个变量所在的行

打印输出结果

上面给打了有很多内置变量进行控制

常用的是

CMAKE_LIBRARY_OUTPUT_DIRECTORY

CMAKE_RUNTIME_OUTPUT_DIRECTORY

CMAKE_ARCHIVE_OUTPUT_DIRECTORY

CMAKE_CURRENT_LIST_DIR

CMAKE_SOURCE_DIR

输出路径设置

.so 库输出路径

#set(CMAKE_LIBRARY_OUTPUT_DIRECTORY "lib")

set(CMAKE_LIBRARY_OUTPUT_DIRECTORY "${CMAKE_CURRENT_LIST_DIR}/lib")

# set(CMAKE_LIBRARY_OUTPUT_DIRECTORY "${CMAKE_CURRENT_LIST_DIR}/../lib")

# set(CMAKE_LIBRARY_OUTPUT_DIRECTORY "${CMAKE_CURRENT_LIST_DIR}/../../lib")

执行程序 dll/ 动态库pdb 输出路径

set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${CMAKE_CURRENT_LIST_DIR}/bin")

静态库lib 动态库.lib地址文件【windows】静态库 .a【linux】静态库 pdb 调试文件

set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY "${CMAKE_CURRENT_LIST_DIR}/lib")

add_subdirectory 实例demo

初始结构

|---log

|---|---log.h

|---|---log.cpp

|---utils

|---|---utils.h

|---|---utils.cpp

|---main.cpp

|---CMakeLists.txt

顶层CMakeLists.txt

cmake_minimum_required(VERSION 3.20)

project(program_structure)

set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY "${CMAKE_CURRENT_LIST_DIR}/lib")

set(CMAKE_LIBRARY_OUTPUT_DIRECTORY "${CMAKE_CURRENT_LIST_DIR}/lib")

set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${CMAKE_CURRENT_LIST_DIR}/bin")

add_subdirectory(log)

add_subdirectory(utils)

add_executable(${PROJECT_NAME} main.cpp)

# 指定包含目录

target_include_directories(${PROJECT_NAME} PRIVATE ${CMAKE_CURRENT_LIST_DIR}/log ${CMAKE_CURRENT_LIST_DIR}/utils)

target_link_libraries(${PROJECT_NAME} log utils)

log 目录下的 CMakeLists.txt

add_library(log STATIC log.cpp log.h)

utils 目录下的 CMakeLists.txt

add_library(log STATIC log.cpp log.h)

构建完成后结构如下

windows 下生成的对象会区分 debug 版本和 release 版本在输出路径上会产生多一级文件夹 Debug/Release

默认Debug

source_group 实例demo

CMakeLists.txt

cmake_minimum_required(VERSION 3.20)

project(cmake_vs_group)

file(WRITE main.cpp [=[

int main()

{

  return 0;

}

]=])

file(WRITE a.cpp "")

file(WRITE b.cpp "")

file(WRITE a.h "")

file(WRITE b.h "")

add_executable(vs_group main.cpp a.cpp b.cpp a.h b.h)

source_group(src FILES a.cpp b.cpp)

source_group(include FILES b.h)

# 后面src 路径 会去掉 root 内容 显示剩下的路径

source_group(TREE . PREFIX include/inc FILES a.h )

构建后效果如下