陕西省交通建设公司网站,怀来建设局网站,wordpress 获取导航栏,北京app制作目录 五、scope 作用域5.1 作用域的类型5.1.1 全局作用域5.1.2 目录作用域5.1.3 函数作用域 六、宏6.1 基本语法6.2 演示代码 七、CMake构建项目7.1 全局变量7.2 写入源码路径7.3 调用子目录cmake脚本7.4 CMakeLists 嵌套(最常用) 八、CMake 与库8.1 CMake生成动静态库8.1.1 动… 目录 五、scope 作用域5.1 作用域的类型5.1.1 全局作用域5.1.2 目录作用域5.1.3 函数作用域 六、宏6.1 基本语法6.2 演示代码 七、CMake构建项目7.1 全局变量7.2 写入源码路径7.3 调用子目录cmake脚本7.4 CMakeLists 嵌套(最常用) 八、CMake 与库8.1 CMake生成动静态库8.1.1 动静态库8.1.2 常见命令8.1.3 生成静态库8.1.3.1 示例8.1.3.2 总结 8.1.4 生成动态库 8.2 CMake调用动静态库8.2.1 静态库调用流程8.2.2 动态库调用流程 五、scope 作用域
5.1 作用域的类型
5.1.1 全局作用域
从CMake脚本开始运行到结束。所有CMakeLists.txt文件共享全局作用域通过set()定义的变量默认是全局变量除非明确在函数或宏中设置为局部变量
set(GLOBAL_VAR I am global)
message(${GLOBAL_VAR}) # 输出: I am global5.1.2 目录作用域
每个目录中的CMakeLists.txt文件有独立的作用域子目录可以继承父目录的变量但子目录中对变量的更改不会影响父目录只在子目录下生效 下面是一个demo理解即可暂时不尝试自己编译
# 顶层 CMakeLists.txt
set(DIR_VAR Parent Directory)
# 添加子目录
add_subdirectory(subdir)# 子目录 subdir/CMakeLists.txt
message(${DIR_VAR}) # 输出: Parent Directory
set(DIR_VAR Child Directory)子目录进行set操作后顶层的 DIR_VAR 不会被子目录的更改影响。
5.1.3 函数作用域
在函数中定义的变量是局部变量只在函数内有效使用set()定义变量时作用域局限于当前函数除非指定PARENT_SCOPE
function(set_local_var)set(LOCAL_VAR Local Scope)message(${LOCAL_VAR}) # 输出: Local Scope
endfunction()set_local_var()
message(${LOCAL_VAR}) # 输出: (空因为超出函数作用域)六、宏
6.1 基本语法
macro(name [arg1 [arg2 ...]])# 宏体
endmacro()name 是宏的名称。[arg1, arg2…] 是参数列表可选。宏没有返回值但可以通过变量或 CACHE 修改全局状态。
6.2 演示代码
cmake_minimum_required(VERSION 3.20.0)macro(Test myVar)set(myVar new value)message (2. argument: ${myVar})
endmacro()set(myVar First value)
message (1. myVar: ${myVar})
Test(value)
message(3. myVar: ${myVar})七、CMake构建项目
7.1 全局变量
在[[#1.2 初体验]]中我们使用了以下代码
project(hello CXX)声明项目名称为 hello并设置主要语言为 CCXX。生成项目相关的全局变量例如 ${PROJECT_NAME}值为 hello${PROJECT_SOURCE_DIR}项目的根目录路径。${PROJECT_BINARY_DIR}构建目录路径。
7.2 写入源码路径
特点
最简单的构建方式。适用于只有一个 CMakeLists.txt 文件的小型项目。 目录结构
MyProject/
├── CMakeLists.txt
├── main.cpp
├──Transportation├──train.h├──tarin.cppCMakeLists.txt
cmake_minimum_required(VERSION 3.20.0)project(MyProject CXX)
add_executable(MyProject main.cpp 需要链接的文件路径)CXX 表示语言是 cpp在原文件中要写对应的.h文件main.cpp:#include Transportation/train.h在这里就不需要再包含但是要包含.cpp文件的路径 构建方法
cmake -B build
cmake --build build
build/项目名称7.3 调用子目录cmake脚本
include方法可以引入子目录中的cmake后缀的配置文件将配置加入 add_executable 目录结构
.
├── CMakeLists.txt
├── main.cpp
└── Transportation├── car.cpp├── car.h├── train.cpp├── train.h└── transportation.cmake在transportation.cmake使用set将变量设置成需要链接的文件
set(trans_sources Transportation/car.cpp Transportation/train.cpp)然后在CMakeLists.txt中就可以直接使用该变量
cmake_minimum_required(VERSION 3.20.0)
project(MyProject CXX)
include(Transportation/transportation.cmake)
add_executable(MyProject main.cpp ${trans_sources})❗️注意要使用include引入子目录下的cmake文件使用变量要用${} 构建方法同上。
7.4 CMakeLists 嵌套(最常用)
target_include_directories 头文件目录的声明target_link_libraries 连接库文件add_subdirectory 添加子目录add_ library 生成库文件默认静态库 目录结构
.
├── CMakeLists.txt
├── main.cpp
└── Transportation├── car.cpp├── car.h├── CMakeLists.txt├── train.cpp└── train.h在子目录的CMakeLists.txt中add_library 命令创建一个名为 Translib 的库该库包含 train.cpp 和 car.cpp 两个源文件的编译结果。
add_library(Translib train.cpp car.cpp)在父目录的CMakeLists.txt中
cmake_minimum_required(VERSION 3.20.0)
project(MyProject CXX)add_subdirectory(Transportation)add_executable(MyApp main.cpp)target_link_libraries(MyApp PUBLIC Translib)target_include_directories(MyApp PUBLIC ${PROJECT_SOURCE_DIR}/Transportation)定义项目
project(MyProject CXX) 声明项目的名称为 MyProject并设置其主要语言为 C。
添加子目录
add_subdirectory(Transportation) 将 Transportation 子目录的构建逻辑纳入父目录中。这会递归执行 Transportation 目录中的 CMakeLists.txt构建 Translib 库。
添加可执行文件
add_executable(MyApp main.cpp) 声明一个名为 MyApp 的可执行目标其源文件为 main.cpp。
链接库
target_link_libraries(MyApp PUBLIC Translib) 将 Translib 库链接到可执行文件 MyApp。PUBLIC表示 Translib 的头文件路径和链接库信息都对 MyProject 和其使用者可见。
包含头文件路径
target_include_directories(MyApp PUBLIC ${PROJECT_SOURCE_DIR}/Transportation) 明确告诉 CMakeMyProject 需要包含 Transportation 目录中的头文件如 car.h 和 train.h这样在main.cpp中包含头文件时就不需要再次包含路径。 构建顺序总结
进入父目录的构建流程
cmake 检测到 add_subdirectory(Transportation)递归构建子目录。子目录生成 Translib 库。
构建父目录目标
构建 main.cpp 并将其链接到已生成的 Translib。
八、CMake 与库
8.1 CMake生成动静态库
8.1.1 动静态库
静态库 常见命名.aLinux/Unix.libWindows。 在链接阶段将汇编生成的目标文件.o与引用到的库一起链接打包到可执行文件中。 对函数库的链接是编译器的链接器在编译阶段完成静态链接的过程 动态库 常见命名.soLinux/Unix.dllWindows.dylibmacOS 动态库是在程序运行时才会被载入到内存当执行到库中代码时就会跳转到目标库。 动态库需要依赖操作系统的动态链接机制 8.1.2 常见命令
file(GLOB ...) 常用于搜索源文件add_library(animal STATIC ${SRC}) 生成静态库add_library(animal SHARED ${SRC}) 生成动态库${LIBRARY_OUTER_PATH} 导出目录
8.1.3 生成静态库
8.1.3.1 示例
当前目录结构如下
.
├── CMakeLists.txt
├── include
│ ├── car.h
│ └── train.h
└── src├── car.cpp└── train.cppCMakeLists.txt
cmake_minimum_required(VERSION 3.20.0)
project(MyProject CXX)file(GLOB SRC ${PROJECT_SOURCE_DIR}/src/*.cpp)
include_directories(${PROJECT_SOURCE_DIR}/include) set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/a)
add_library(trans STATIC ${SRC})下面来解释一下上面的代码
project(MyProject CXX)在[[#7.1 全局变量]]中我们了解到使用project时除声明项目名称外还会生成项目相关的全局变量例如
${PROJECT_NAME}值为 MyProject。${PROJECT_SOURCE_DIR}项目的根目录路径。${PROJECT_BINARY_DIR}构建目录路径。 file(GLOB SRC ${PROJECT_SOURCE_DIR}/src/*.cpp)作用
使用 file(GLOB ...) 命令搜索 src 目录下所有以 .cpp 结尾的文件并将它们的路径存入变量 SRC。GLOB 是 CMake 提供的文件搜索命令用于匹配文件路径。示例如果 src 目录下有 car.cpp 和 train.cpp那么 SRC 的值将是
/path/to/src/car.cpp
/path/to/src/train.cppinclude_directories(${PROJECT_SOURCE_DIR}/include) 作用
将 include 目录即 car.h 和 train.h 所在目录添加到项目的头文件搜索路径中。等效于将 -I/path/to/include 传递给编译器。这样源文件中可以直接使用而无需写完整路径
#include car.h
#include train.hset(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/a)作用
指定生成的库文件的输出目录为项目根目录下的 a 子目录。如果没有这一行CMake 默认将库文件输出到构建目录中。 add_library(trans STATIC ${SRC})作用
定义一个名为 trans 的静态库STATIC。SRC 中列出的源文件如 car.cpp 和 train.cpp将被编译并打包成静态库。
8.1.3.2 总结
生成静态库的基本步骤
# 1. 设置 CMake 最低版本
cmake_minimum_required(VERSION 3.20)
# 2. 定义项目名称和语言
project(MyStaticLibrary LANGUAGES CXX)# 3. 添加头文件路径
include_directories(${PROJECT_SOURCE_DIR}/include)
# 4. 查找源文件
file(GLOB SRC_FILES ${PROJECT_SOURCE_DIR}/src/*.cpp)# 5. 设置库文件的输出路径
set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/a)# 6. 添加静态库 声明一个静态库目标STATIC 表示静态库指定构成静态库的源文件。
add_library(MyStaticLib STATIC ${SRC_FILES})8.1.4 生成动态库
生成动态库与生成静态库的步骤类似只需要将添加静态库的STATIC改为SHARED(动态库也叫共享库)
set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/so)
add_library(trans SHARED ${SRC})8.2 CMake调用动静态库
8.2.1 静态库调用流程
指定静态库的路径添加可执行文件链接静态库添加库的头文件路径 假设当前目录如下
flashVM-12-10-ubuntu:~/2024/12/14_cmake/useLib$ tree -L 2
.
├── CMakeLists.txt
├── include
│ ├── car.h
│ └── train.h
├── Lib
│ ├── libtrans.a
│ └── libtrans.so
└── main.cpp如果已经生成了动静态库可以直接删除src目录但是建议保留include目录下面来看CMakeLists.txt的具体编写
cmake_minimum_required(VERSION 3.20.0)
project(MyProject CXX)# 指定静态库的路径
set(STATIC_LIB_PATH ${PROJECT_SOURCE_DIR}/Lib/libtrans.a)
# 添加可执行文件
add_executable(MyExecutable main.cpp)
# 链接静态库仅作用于 MyExecutable
target_link_libraries(MyExecutable PRIVATE ${STATIC_LIB_PATH})
# 添加库的头文件路径仅作用于 MyExecutable
target_include_directories(MyExecutable PRIVATE ${PROJECT_SOURCE_DIR}/include)8.2.2 动态库调用流程
指定动态库的路径添加可执行文件链接静态库添加库的头文件路径
cmake_minimum_required(VERSION 3.20.0)
project(MyProject CXX)# 指定动态库的路径
set(DYNAMIC_LIB_PATH ${PROJECT_SOURCE_DIR}/Lib/libtrans.so)
# 添加可执行文件
add_executable(MyExecutable main.cpp)
# 链接动态库仅作用于 MyExecutable
target_link_libraries(MyExecutable PRIVATE ${DYNAMIC_LIB_PATH})
# 添加库的头文件路径仅作用于 MyExecutable
target_include_directories(MyExecutable PRIVATE ${PROJECT_SOURCE_DIR}/include)
