如何让CMake先安装ZLib库再用于Qt项目构建？

问题根源 #

构建报错源于两个核心问题：

1. ExternalProject_Add默认不执行install步骤：你指定了CMAKE_INSTALL_PREFIX但未触发install流程，导致zlib-install目录为空，库文件根本没生成到目标路径。
2. 依赖关联不完整：add_dependencies仅保证zlib的build阶段完成，但install阶段才会把库和头文件复制到指定目录，主项目在install完成前就尝试链接，自然找不到文件。

修复方案 #

步骤1：修改ExternalProject_Add配置，强制触发install #

在ExternalProject_Add中添加BUILD_COMMAND，让zlib构建完成后自动执行install，同时同步主项目的构建配置（Debug/Release）：

ExternalProject_Add(
    zlib
    PREFIX ${ZLIB_BINARY_DIR}
    GIT_REPOSITORY https://github.com/madler/zlib.git
    GIT_TAG master
    CMAKE_ARGS 
        -DCMAKE_INSTALL_PREFIX=${CMAKE_BINARY_DIR}/zlib-install
        -DCMAKE_BUILD_TYPE=$<CONFIG>  # 同步主项目的构建配置
    BUILD_COMMAND 
        ${CMAKE_COMMAND} --build . --config $<CONFIG> --target install  # 构建后立即安装
)

步骤2：动态获取zlib安装路径，避免硬编码 #

使用ExternalProject_Get_Property获取zlib的实际安装目录，同时用CMake内置变量处理跨平台库文件名差异（Windows下是zlib.lib，Linux/macOS下是libz.a）：

# 获取zlib的安装目录
ExternalProject_Get_Property(zlib INSTALL_DIR)
set(ZLIB_INCLUDE_DIR ${INSTALL_DIR}/include)
set(ZLIB_LIBRARY ${INSTALL_DIR}/lib/${CMAKE_STATIC_LIBRARY_PREFIX}z${CMAKE_STATIC_LIBRARY_SUFFIX})

步骤3：更新主项目的链接与依赖配置 #

用上述变量替换硬编码路径，确保主项目等待zlib安装完成后再构建：

target_link_libraries(appBuildTest
    PRIVATE Qt6::Quick
    ${ZLIB_LIBRARY}
)

target_include_directories(appBuildTest
    PRIVATE ${ZLIB_INCLUDE_DIR}
)

add_dependencies(appBuildTest zlib)

完整修复后的CMakeLists.txt #

cmake_minimum_required(VERSION 3.16)

project(BuildTest VERSION 0.1 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(Qt6 6.5 REQUIRED COMPONENTS Quick)

qt_standard_project_setup(REQUIRES 6.5)

set(ZLIB_BINARY_DIR "${CMAKE_BINARY_DIR}/zlib-build")

# Add zlib as an external project using Git to download it
include(ExternalProject)

ExternalProject_Add(
    zlib
    PREFIX ${ZLIB_BINARY_DIR}
    GIT_REPOSITORY https://github.com/madler/zlib.git
    GIT_TAG master
    CMAKE_ARGS 
        -DCMAKE_INSTALL_PREFIX=${CMAKE_BINARY_DIR}/zlib-install
        -DCMAKE_BUILD_TYPE=$<CONFIG>
    BUILD_COMMAND 
        ${CMAKE_COMMAND} --build . --config $<CONFIG> --target install
)

# 获取zlib的安装路径
ExternalProject_Get_Property(zlib INSTALL_DIR)
set(ZLIB_INCLUDE_DIR ${INSTALL_DIR}/include)
set(ZLIB_LIBRARY ${INSTALL_DIR}/lib/${CMAKE_STATIC_LIBRARY_PREFIX}z${CMAKE_STATIC_LIBRARY_SUFFIX})

qt_add_executable(appBuildTest
    main.cpp
)

qt_add_qml_module(appBuildTest
    URI BuildTest
    VERSION 1.0
    QML_FILES
        Main.qml
)

target_link_libraries(appBuildTest
    PRIVATE Qt6::Quick
    ${ZLIB_LIBRARY}
)

target_include_directories(appBuildTest
    PRIVATE ${ZLIB_INCLUDE_DIR}
)

# 确保主项目等待zlib安装完成
add_dependencies(appBuildTest zlib)

# Install the application
include(GNUInstallDirs)
install(TARGETS appBuildTest
    BUNDLE DESTINATION .
    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
)

额外注意事项 #

1. 清理旧的构建目录，重新运行CMake生成构建文件，避免缓存干扰。
2. Qt Creator中确保构建配置（Debug/Release）与CMake传递的一致，否则可能出现库版本不匹配的问题。
3. 如果是Windows环境，zlib默认会构建静态库，若需要动态库，可在CMAKE_ARGS中添加-DBUILD_SHARED_LIBS=ON。

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