如何让CMake在lighttpd.tar.gz变更时重建ExternalProject？

这个问题很常见——默认情况下，CMake的ExternalProject模块只会在第一次构建时处理归档文件，之后不会自动检测原归档的变化。下面给你两种可靠的解决方案，从精准到灵活：

方法1：通过哈希值检测归档内容变化（推荐） #

CMake的ExternalProject_Add支持URL_HASH参数，它会验证归档文件的哈希值。当原lighttpd.tar.gz的内容变更时，哈希值不匹配，CMake就会自动重新处理（本地复制、解压并重建整个lighttpd项目）。

操作步骤： #

1. 先计算当前lighttpd.tar.gz的SHA256哈希值（也可以用MD5、SHA1等，推荐安全性更高的SHA256）：
   在终端执行命令：

   sha256sum ${PROJECT_SOURCE_DIR}/ext/lighttpd/lighttpd.tar.gz
   

   得到类似abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890的哈希字符串。

2. 修改你的CMake配置，添加URL_HASH参数：

   ExternalProject_Add( lighttpd
     URL "${PROJECT_SOURCE_DIR}/ext/lighttpd/lighttpd.tar.gz"
     URL_HASH SHA256=abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890 # 替换成你计算出的哈希值
     SOURCE_DIR "${EXTERNAL_INSTALL_PATH}/lighttpd"
   )
   
   ExternalProject_Add_Step( lighttpd copy2build
     COMMAND cp -a ${EXTERNAL_INSTALL_PATH}/lighttpd/bin/. ${EXECUTABLE_OUTPUT_PATH}
     COMMAND cp -a ${EXTERNAL_INSTALL_PATH}/lighttpd/lib/. ${LIBRARY_OUTPUT_PATH}
     DEPENDEES install
   )
   

这样，每次CMake配置或构建时，都会检查归档文件的哈希值。如果文件内容发生变化，哈希不匹配，CMake会自动清理之前的lighttpd构建目录，重新执行整个外部项目的构建流程。

方法2：基于文件修改时间触发重建（适合频繁修改归档的场景） #

如果你不想每次修改归档都重新计算哈希，可以通过自定义目标和依赖，让CMake检测归档文件的修改时间，触发重建。

修改后的配置： #

# 创建自定义目标，让CMake监控原归档文件的修改时间
add_custom_target(lighttpd_tarball
  DEPENDS "${PROJECT_SOURCE_DIR}/ext/lighttpd/lighttpd.tar.gz"
)

# 配置ExternalProject，关联自定义目标并强制更新
ExternalProject_Add( lighttpd
  URL "${PROJECT_SOURCE_DIR}/ext/lighttpd/lighttpd.tar.gz"
  SOURCE_DIR "${EXTERNAL_INSTALL_PATH}/lighttpd"
  # 让外部项目依赖归档文件的监控目标
  DEPENDS lighttpd_tarball
  # 禁用断开模式，确保CMake不跳过更新检查
  UPDATE_DISCONNECTED OFF
  # 强制每次从原路径复制归档到构建目录，避免使用缓存的旧文件
  DOWNLOAD_COMMAND ${CMAKE_COMMAND} -E copy "${PROJECT_SOURCE_DIR}/ext/lighttpd/lighttpd.tar.gz" "${CMAKE_CURRENT_BINARY_DIR}/lighttpd.tar.gz"
  DOWNLOAD_DIR "${CMAKE_CURRENT_BINARY_DIR}"
)

ExternalProject_Add_Step( lighttpd copy2build
  COMMAND cp -a ${EXTERNAL_INSTALL_PATH}/lighttpd/bin/. ${EXECUTABLE_OUTPUT_PATH}
  COMMAND cp -a ${EXTERNAL_INSTALL_PATH}/lighttpd/lib/. ${LIBRARY_OUTPUT_PATH}
  DEPENDEES install
)

这个方法的核心逻辑：

• add_custom_target让CMake持续监控归档文件的修改时间；
• DOWNLOAD_COMMAND绕过CMake的默认缓存机制，每次都从原路径复制最新的归档文件；
• UPDATE_DISCONNECTED OFF确保CMake不会忽略对归档文件的更新检查。

当你修改lighttpd.tar.gz后，下次构建时，CMake会检测到文件更新，自动触发lighttpd外部项目的重新下载、解压和构建。

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