CMake中如何让第三方库K使用源码编译的libpng且不修改K源码？

核心思路 #

利用CMake的find_package查找机制，通过提前设置变量、指定查找路径或禁用系统查找的方式，让K执行find_package(PNG REQUIRED)时，优先使用我们自己编译的libpng版本。

具体实现方案 #

方案一：手动设置PNG相关CMake变量（直接可靠） #

在引入第三方库K的add_subdirectory之前，手动覆盖find_package(PNG)会用到的核心变量，直接指向我们编译的libpng：

# 先引入并编译libpng源码
add_subdirectory(libpng)

# 设置PNG相关变量，让K的find_package直接复用我们的编译结果
set(PNG_FOUND TRUE)
set(PNG_INCLUDE_DIRS ${libpng_SOURCE_DIR})  # libpng源码中的头文件路径
set(PNG_LIBRARIES png_static)  # 我们编译出的静态库目标
set(PNG_VERSION_STRING ${PNG_VERSION})  # 可选，传递libpng版本号

# 之后引入第三方库K
add_subdirectory(K)

这种方式会让K的find_package(PNG REQUIRED)直接使用我们预设的变量，完全跳过系统库查找流程。

方案二：通过CMAKE_PREFIX_PATH指定libpng安装路径 #

如果你的libpng已经编译并安装到本地目录（比如./build/libpng_install），可以将该路径加入CMAKE_PREFIX_PATH，让find_package优先查找这里的库配置：

# 先编译并安装libpng到本地目录
add_subdirectory(libpng)
install(TARGETS png_static DESTINATION ${CMAKE_CURRENT_BINARY_DIR}/libpng_install/lib)
install(FILES ${libpng_SOURCE_DIR}/png.h ${libpng_SOURCE_DIR}/pngconf.h DESTINATION ${CMAKE_CURRENT_BINARY_DIR}/libpng_install/include)

# 将安装路径加入查找前缀列表
list(APPEND CMAKE_PREFIX_PATH ${CMAKE_CURRENT_BINARY_DIR}/libpng_install)

# 引入第三方库K
add_subdirectory(K)

CMake会优先在CMAKE_PREFIX_PATH指定的路径中查找PNGConfig.cmake等配置文件，从而使用我们编译的libpng版本。

方案三：禁用系统查找并注册别名目标 #

通过CMAKE_DISABLE_FIND_PACKAGE_PNG强制跳过系统查找，同时将我们的libpng目标注册为K可能使用的PNG::PNG别名：

add_subdirectory(libpng)

# 禁用系统PNG库的查找
set(CMAKE_DISABLE_FIND_PACKAGE_PNG TRUE)

# 将我们的静态库注册为PNG::PNG别名，适配K中可能使用的命名空间目标
add_library(PNG::PNG ALIAS png_static)

# 引入第三方库K
add_subdirectory(K)

注意事项 #

• 所有libpng相关的配置必须在add_subdirectory(K)之前执行，CMake是顺序执行的，晚于该步骤的设置不会生效。
• 如果使用libpng动态库，将示例中的png_static替换为对应的动态库目标（通常是png）即可。
• 不同版本的libpng头文件路径可能略有差异，需根据实际源码结构调整PNG_INCLUDE_DIRS。

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