cmake target_sources指令详解

target_sources 指令用于为 CMake 目标添加源文件。这种方法的优点在于它可以将源文件添加到目标中,并且可以在 CMake 的生成阶段自动更新。

语法

cpp 复制代码
target_sources(<target> [INTERFACE|PUBLIC|PRIVATE] <source1> <source2> ...)
  • target: 要添加源文件的目标,通常是通过 add_executable 或 add_library 定义的目标。
  • INTERFACE: 指定这些源文件对其他目标是可见的,但不会包含在目标本身的构建中。这通常用于接口库。
  • PUBLIC: 指定这些源文件对其他链接到该目标的目标是可见的,同时也包含在目标本身的构建中。
  • PRIVATE: 指定这些源文件仅对目标本身可见,不会传播到链接到该目标的其他目标。

示例

  1. 为库添加源文件:
cpp 复制代码
add_library(my_library STATIC lib1.cpp lib2.cpp)

# 添加更多源文件到 my_library
target_sources(my_library PRIVATE lib3.cpp lib4.cpp)

在这个例子中,lib3.cpp 和 lib4.cpp 被添加到 my_library 目标中,而 lib1.cpp 和 lib2.cpp 是在 add_library 中最初定义的。

  1. 使用生成的源文件:
cpp 复制代码
add_library(my_library STATIC lib1.cpp)

# 假设生成了额外的源文件,例如通过某些预处理操作
file(GLOB GENERATED_SOURCES "generated/*.cpp")

# 将生成的源文件添加到目标
target_sources(my_library PRIVATE ${GENERATED_SOURCES})

这个例子中,GENERATED_SOURCES 是通过 file(GLOB ...) 生成的一组源文件,它们被添加到 my_library 目标中。

  1. 为接口库添加源文件:
cpp 复制代码
add_library(my_interface_library INTERFACE)

# 添加源文件到接口库
target_sources(my_interface_library INTERFACE interface_file.cpp)

接口库通常不直接编译源文件,但你可以使用 target_sources 为它定义源文件,以便使用该库的其他目标能够访问这些源文件。

使用场景

  • 动态更新源文件列表: 使用 target_sources 可以动态地管理源文件列表,这在自动生成文件时特别有用。
  • 清晰的目标组织: 通过 target_sources 可以更清晰地组织目标的源文件,而不必在 add_library 或 add_executable 中定义所有源文件。
  • 跨目标源文件共享: 可以将公共源文件添加到多个目标中,使源文件的管理更加集中。

通过 target_sources,你可以更灵活地管理目标的源文件,并在 CMake 配置过程中更好地控制构建逻辑。

相关推荐
似霰3 分钟前
安卓智能指针sp、wp、RefBase浅析
android·c++·binder
芊寻(嵌入式)13 分钟前
C转C++学习笔记--基础知识摘录总结
开发语言·c++·笔记·学习
獨枭15 分钟前
C++ 项目中使用 .dll 和 .def 文件的操作指南
c++
霁月风18 分钟前
设计模式——观察者模式
c++·观察者模式·设计模式
橘色的喵19 分钟前
C++编程:避免因编译优化引发的多线程死锁问题
c++·多线程·memory·死锁·内存屏障·内存栅栏·memory barrier
QAQ小菜鸟39 分钟前
一、初识C语言(1)
c语言
何曾参静谧1 小时前
「C/C++」C/C++ 之 变量作用域详解
c语言·开发语言·c++
互联网打工人no11 小时前
每日一题——第一百二十一题
c语言
AI街潜水的八角1 小时前
基于C++的决策树C4.5机器学习算法(不调包)
c++·算法·决策树·机器学习
JSU_曾是此间年少2 小时前
数据结构——线性表与链表
数据结构·c++·算法