😈「CSDN主页」:传送门
😈「Bilibil首页」:传送门
😈「本文的内容」:CMake入门教程
😈「动动你的小手」:点赞👍收藏⭐️评论📝
文章目录
- include子模块
- 举个例子
- include 优先级
- include简写
- 组织工程技巧
include子模块
要在CMake中引用子模块的.cmake
文件,可以使用include()
命令。include()
命令用于包含并执行指定的CMake脚本文件。
假设你的子模块文件名为submodule.cmake
,位于与主CMakeLists.txt
文件相同的目录中,你可以在主CMakeLists.txt
文件中使用以下命令引用该子模块:
include(submodule.cmake)
如果子模块文件位于主CMakeLists.txt
文件的上级目录中,你可以使用相对路径引用子模块:
include(../submodule.cmake)
如果子模块文件位于不同的目录中,你可以使用绝对路径引用子模块:
include(/path/to/submodule.cmake)
请确保在引用子模块文件之前,子模块文件已经存在,并包含了你需要的定义、函数或宏等内容。
举个例子
以下是一个简单的示例,演示如何在CMake中引用子模块的.cmake
文件。
假设你有以下目录结构:
project/|- CMakeLists.txt|- submodule/|- submodule.cmake
首先,创建主CMakeLists.txt
文件,并引用子模块文件:
cmake_minimum_required(VERSION 3.12)
project(MyProject)# 引用子模块
include(submodule/submodule.cmake)# 主项目的设置和构建逻辑
...
然后,在submodule
目录中创建submodule.cmake
文件,并在其中定义一些内容:
# submodule.cmake# 定义一个函数
function(print_message)message("Hello from submodule!")
endfunction()# 定义一个变量
set(SUBMODULE_VARIABLE "This is a submodule variable")
现在,当你构建主项目时,子模块文件将被引用并执行。你可以在主项目的构建过程中使用子模块中定义的函数和变量。例如,在主CMakeLists.txt
中添加以下内容:
# 主项目的设置和构建逻辑# 调用子模块中的函数
print_message()# 使用子模块中的变量
message("Submodule variable: ${SUBMODULE_VARIABLE}")
当你执行CMake构建时,你将看到以下输出:
Hello from submodule!
Submodule variable: This is a submodule variable
这个例子展示了如何在CMake中引用子模块的.cmake
文件,并使用子模块中定义的函数和变量。你可以根据自己的需求扩展和修改子模块文件的内容。
include 优先级
在CMake中,include()
命令用于包含其他CMake脚本文件。当指定文件名时,CMake会按照特定的搜索路径来查找该文件。
CMake的搜索路径包括以下几个位置:
- 当前源代码目录:CMake会首先在当前源代码目录中搜索指定的文件。
- CMake模块路径:CMake会搜索预定义的模块路径,这些路径包括CMake的安装路径、系统级的CMake模块路径以及用户自定义的CMake模块路径。可以通过设置
CMAKE_MODULE_PATH
变量来添加自定义的CMake模块路径。 - 环境变量:CMake还会搜索名为
CMAKE_INCLUDE_PATH
的环境变量中指定的路径。 - 系统默认路径:CMake会搜索系统默认的CMake模块路径,这些路径包括操作系统特定的CMake模块目录。
如果要引用一个子模块中的文件,可以在include()
命令中使用相对路径或绝对路径来指定文件的位置。例如:
include(submodule/file.cmake)
include(/path/to/submodule/file.cmake)
这样可以明确指定要包含的文件的位置,而不依赖于搜索路径。
总之,CMake会按照上述搜索路径的顺序查找要包含的文件,如果找到匹配的文件,就会将其包含到当前的CMake脚本中。
include简写
在CMake中,include()
命令的括号内可以不写.cmake
扩展名。CMake会自动搜索指定的文件,并将其包含到当前的CMake脚本中。
因此,你可以这样写:
include(submodule)
这将引用名为submodule.cmake
的文件,并将其包含到当前的CMake脚本中。CMake会搜索与给定名称匹配的文件,并自动添加.cmake
扩展名。
请注意,如果存在多个与给定名称匹配的文件,CMake将按照特定的搜索顺序选择其中之一。如果你想确保引用的是特定的文件,建议在include()
命令中包含完整的文件路径或使用相对路径来指定文件的位置。
组织工程技巧
- 封装函数、编译参数等配置到.cmake文件中,总工程文件进行包含
- include的时候,简化include(xxxx),然后设置CMAKE_MODULE_PATH环境变量