CMake导出静态库X时如何隐藏rapidjson依赖并静态打包？

API 探路者

2026-6-16

问题：静态库打包时隐藏rapidjson依赖

我正在创建名为X的静态库，该库的.cpp文件中使用了rapidjson库。我希望导出此静态库时隐藏rapidjson依赖，让其他项目仅需通过target_link_libraries(another_project PUBLIC X)即可链接X。我的CMake配置如下：

add_library(X STATIC
    hub.cpp
)

target_include_directories(X PUBLIC
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/..>
    $<INSTALL_INTERFACE:include>
)

get_target_property(X_INCLUDE_DIRS X INTERFACE_INCLUDE_DIRECTORIES)

target_link_libraries(X
    PUBLIC
    Y // this can be visible
    PRIVATE
    rapidjson // this should not required when another project links to X
)

install(TARGETS X
    EXPORT X-targets
    ARCHIVE DESTINATION lib
)

install(DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/
    DESTINATION include/X
    FILES_MATCHING PATTERN "*.h" 
)

install(EXPORT X-targets
    FILE X-config.cmake
    NAMESPACE X::
    DESTINATION lib/X
)

但安装并链接X后，仍需要添加find_package(RapidJson REQUIRED)语句。由于rapidjson仅在C++文件中使用，我希望对终端用户隐藏该依赖，请问是否可以将rapidjson的函数静态打包进X静态库中？

解决方案

可以将rapidjson的代码静态打包进你的静态库X中，不过要先明确rapidjson的核心特性：它是一个头文件库（header-only library），所有实现逻辑都在头文件内，没有预编译的二进制库文件。

你的问题核心在于CMake依然在传递rapidjson的依赖，按以下步骤调整即可解决：

严格控制rapidjson的依赖范围
确保rapidjson的包含路径和依赖仅对X库的私有编译生效，不会传递给链接X的项目。如果是通过find_package引入的rapidjson，修改链接配置：
```
target_link_libraries(X
    PUBLIC Y
    PRIVATE rapidjson::rapidjson
)
```
若你是手动引入rapidjson的头文件，则将其包含目录设为私有：
```
target_include_directories(X PRIVATE ${RAPIDJSON_INCLUDE_DIR})
```
这样CMake就不会把rapidjson的相关配置写入X-config.cmake，也就不会传递给下游项目。
彻底封装rapidjson的使用
检查你的静态库X的所有对外公开的.h文件，确保：
- 没有包含任何rapidjson的头文件
- 没有暴露rapidjson的类型（比如将其作为函数参数、返回值，或是类的成员变量类型）
  所有rapidjson的操作必须完全封装在.cpp文件内部，对外只暴露你自定义的接口和类型。
验证安装后的配置
安装完成后，查看生成的X-config.cmake文件，确认其中没有rapidjson相关的依赖项。如果配置正确，该文件只会包含X本身和Y的依赖信息。

只要做到以上几点，下游项目仅通过target_link_libraries(another_project PUBLIC X)就能正常链接X，完全不需要感知rapidjson的存在，也无需添加find_package(RapidJson REQUIRED)。

内容的提问来源于stack exchange，提问作者berkeyvx