5. 2.1 目标的概念与类型

4.1 适用场景

对象库非常适合以下场景：

• 一组源文件需要在多个目标（可执行文件或其他库）中复用，但你不想生成一个独立的静态库文件；
• 你想避免静态库链接时可能带来的符号重复或链接顺序问题；
• 构建大型项目时，将公共代码编译为对象文件直接嵌入最终目标。

4.2 定义与使用

add_library(common_objs OBJECT file1.cpp file2.cpp)

# 方式1：在可执行文件中复用对象文件
add_executable(app1 main1.cpp)
target_sources(app1 PRIVATE $)

# 方式2：在另一个库中复用对象文件
add_library(combined STATIC combined.cpp)
target_sources(combined PRIVATE $)

这里使用了生成器表达式（Generator Expression） $<TARGET_OBJECTS:common_objs>，它会在构建时将对象库包含的对象文件列表展开。

4.3 对象库的局限性

• 对象库不能像普通库那样直接用于 target_link_libraries（虽然 CMake 3.12+ 支持链接对象库，但底层逻辑本质还是对象文件传递）；
• 对象库的属性传播能力不如普通库，比如包含目录不会自动传递，需要额外处理。

# CMake 3.12+ 支持直接链接对象库（推荐在新版本中使用）
add_executable(modern_app main.cpp)
target_link_libraries(modern_app PRIVATE common_objs)

五、接口库：INTERFACE

接口库是 Modern CMake 中极具创造力的设计。它不产生任何编译输出（没有实体文件生成），纯粹作为一个逻辑目标存在，用于传递编译配置（头文件路径、宏定义、编译选项等）。

5.1 纯头文件库（Header-Only Library）

纯头文件库没有 .cpp 实现文件，所有代码都在 .h 或 .hpp 中。使用接口库可以完美地建模这类库：

add_library(my_headers INTERFACE)

# 为接口库附加属性
target_include_directories(my_headers INTERFACE
    ${CMAKE_CURRENT_SOURCE_DIR}/include
)

target_compile_definitions(my_headers INTERFACE
    USE_FAST_ALGORITHM=1
)

# 其他目标链接该接口库后，会自动获得上述配置
add_executable(consumer main.cpp)
target_link_libraries(consumer PRIVATE my_headers)

关键点在于使用 INTERFACE 可见性。这表示这些属性只用于依赖该目标的其他目标，而接口库自身不需要编译（因为它没有源文件）。

5.2 作为配置集合

接口库还可以用来封装一组通用的编译警告或选项，方便在多个目标间复用：

add_library(project_warnings INTERFACE)

if(MSVC)
    target_compile_options(project_warnings INTERFACE /W4 /WX)
else()
    target_compile_options(project_warnings INTERFACE -Wall -Wextra -Wpedantic)
endif()

# 所有项目目标统一链接此接口库
add_executable(app main.cpp)
target_link_libraries(app PRIVATE project_warnings)

六、导入目标（IMPORTED）与别名目标（ALIAS）

6.1 导入目标：IMPORTED

导入目标用于引用已经构建好的外部库（非当前 CMake 项目生成）。它告诉 CMake：“这个库已经存在于系统某处，你只需要知道如何链接它即可。” 这在 find_package 查找系统库时非常常见。

# 手动创建一个导入的静态库目标
add_library(external_lib STATIC IMPORTED)

# 指定库文件的实际位置
set_target_properties(external_lib PROPERTIES
    IMPORTED_LOCATION "/usr/local/lib/libexternal.a"
    INTERFACE_INCLUDE_DIRECTORIES "/usr/local/include"
)

# 使用它
add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE external_lib)

对于动态库，如果平台需要（如 Windows），还需要设置 IMPORTED_IMPLIB（指向导入库 .lib）和 IMPORTED_LOCATION（指向 .dll）。

6.2 全局导入目标

默认情况下，导入目标的作用域仅限于当前目录及其子目录。如果希望在整个构建树中都能引用，需要添加 GLOBAL 关键字：

add_library(png SHARED IMPORTED GLOBAL)
set_target_properties(png PROPERTIES
    IMPORTED_LOCATION "${PNG_LIBRARY}"
    INTERFACE_INCLUDE_DIRECTORIES "${PNG_INCLUDE_DIR}"
)

6.3 别名目标：ALIAS

别名目标是为已有的目标创建一个额外的名称。它本身不生成新的构建规则，只是原目标的“快捷方式”。

add_library(real_math STATIC math.cpp)

# 创建别名
add_library(Math::Core ALIAS real_math)

# 使用别名链接（命名空间风格，更具可读性）
add_executable(app main.cpp)
target_link_libraries(app PRIVATE Math::Core)

别名目标有两个重要限制：

• 只能为库目标创建别名（不可用于可执行文件）；
• 不能为 IMPORTED 库创建别名（但可以为 ALIAS 本身再创建引用，需注意版本限制）。

七、目标属性概览

每种目标类型都附带有大量属性，控制其编译、链接和输出行为。掌握如何查看和设置属性，是调试 CMake 构建的关键技能。

7.1 查看目标属性

使用 get_target_property 命令读取属性值。如果属性未设置，结果会落入 <variable>-NOTFOUND。

add_executable(demo main.cpp)

# 查看目标的源文件列表
get_target_property(SRCS demo SOURCES)
message(STATUS "demo sources: ${SRCS}")

# 查看输出名称
get_target_property(OUT_NAME demo OUTPUT_NAME)
if(OUT_NAME)
    message(STATUS "demo output name: ${OUT_NAME}")
else()
    message(STATUS "demo uses default output name")
endif()

7.2 设置目标属性

使用 set_target_properties 可以同时设置多个属性：

add_library(engine SHARED engine.cpp renderer.cpp)

set_target_properties(engine PROPERTIES
    # 输出文件名
    OUTPUT_NAME "MyGameEngine"
    
    # Windows 运行时输出目录（.exe, .dll）
    RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin"
    
    # Linux/macOS 动态库输出目录（.so, .dylib）
    LIBRARY_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/lib"
    
    # 静态库/导入库输出目录（.a, .lib）
    ARCHIVE_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/lib"
    
    # C++ 标准
    CXX_STANDARD 17
    CXX_STANDARD_REQUIRED ON
    
    # 位置无关代码（对动态库很重要）
    POSITION_INDEPENDENT_CODE ON
)

7.3 常用目标属性速查表

下表列举了日常开发中最常用的目标属性：

7.4 属性设置的最佳实践

在 Modern CMake 中，虽然 set_target_properties 很强大，但更推荐使用专用的 target_* 命令来操作属性，因为它们能更好地处理可见性（PRIVATE/PUBLIC/INTERFACE）和传播机制：

• 使用 target_compile_definitions() 代替直接设置 COMPILE_DEFINITIONS；
• 使用 target_include_directories() 代替直接设置 INCLUDE_DIRECTORIES；
• 使用 target_compile_options() 代替直接设置 COMPILE_OPTIONS；
• 使用 target_link_libraries() 管理依赖。

这些命令的详细用法，我们将在后续章节深入讲解。

八、小结

本节我们系统梳理了 CMake 中所有目标类型及其适用场景：

1. add_executable：构建可执行文件，支持 WIN32、MACOSX_BUNDLE、EXCLUDE_FROM_ALL 等选项；
2. add_library 实体库：STATIC（静态库）、SHARED（动态库）、MODULE（插件模块），默认类型受 BUILD_SHARED_LIBS 控制；
3. OBJECT 对象库：只生成对象文件，用于代码复用，避免生成独立库文件；
4. INTERFACE 接口库：不生成实体，用于传递头文件路径、编译选项等配置，是头文件库和配置集合的绝佳抽象；
5. IMPORTED 导入目标：引用外部已构建的库，设置其位置及接口属性；
6. ALIAS 别名目标：为已有库创建命名空间风格的别名，提升代码可读性。

目标是 Modern CMake 的核心载体，后续我们将继续学习如何通过 target_link_libraries、target_include_directories 等命令在目标之间建立依赖关系，实现“基于目标”的现代构建管理。下节见！