CMake：为何私有目标需安装规则？如何隐藏realtime_version目标？

你的核心需求是把realtime_version静态库的代码直接编译进realtime主库，同时只暴露realtime给外部。报错的原因是：即使你用PRIVATE链接静态库，CMake仍然会记录realtime对realtime_version的依赖关系，导出realtime时会检查所有关联目标是否被处理（安装或导出），因此触发错误。

最优解决方案：将realtime_version改为OBJECT库 #

OBJECT库是CMake专门用来生成目标文件集合的类型，它的代码会直接被合并到链接它的主库中，不会生成独立的库文件，自然不会产生依赖导出的问题。修改代码如下：

...
add_library(${PROJECT_NAME} realtime_client.cpp)
...
configure_file(version/realtime_version.cpp.in realtime_version.cpp @ONLY)
# 将STATIC改为OBJECT，生成目标文件而非独立静态库
add_library(realtime_version OBJECT ${CMAKE_CURRENT_BINARY_DIR}/realtime_version.cpp)
target_link_libraries(${PROJECT_NAME} PRIVATE realtime_version)
...

修改后，realtime_version的目标文件会直接嵌入realtime库，不需要为它编写任何安装规则，导出realtime时也不会再触发依赖检查。

备选方案：保留STATIC库但屏蔽导出检查 #

如果你坚持使用STATIC库，需要通过以下步骤让CMake忽略realtime_version的导出要求：

add_library(realtime_version STATIC ${CMAKE_CURRENT_BINARY_DIR}/realtime_version.cpp)
# 标记该库不参与默认构建，也不被导出
set_target_properties(realtime_version PROPERTIES EXCLUDE_FROM_ALL ON)
# 确保主库链接时合并静态库内容（若主库是动态库，需给realtime_version添加POSITION_INDEPENDENT_CODE属性）
target_link_libraries(${PROJECT_NAME} PRIVATE realtime_version)
# 关键：清空主库在安装接口中的依赖列表，告诉CMake安装后不需要realtime_version
set_target_properties(${PROJECT_NAME} PROPERTIES
  INTERFACE_LINK_LIBRARIES "$<INSTALL_INTERFACE:>"
)

为什么原做法不生效？ #

静态库的PRIVATE链接仅意味着外部使用realtime时不需要链接realtime_version，但CMake仍然会在内部记录realtime构建时依赖realtime_version的库文件。当你导出realtime目标时，CMake会假设安装后的realtime仍然需要依赖realtime_version，因此要求它必须被安装或加入导出集——这和你想把代码合并进主库的需求冲突。而OBJECT库从根本上避免了这个问题，因为它没有独立的库文件，只是主库的一部分代码。

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