如何用ExternalProject_Add集成Makefile项目HDiffPatch并实现库链接？

错误原因 #

ExternalProject_Add 默认将外部项目当作CMake项目处理，会自动执行cmake命令查找CMakeLists.txt。但HDiffPatch仅提供Makefile构建脚本，因此必须显式覆盖默认的CMake流程，指定用Makefile构建。

正确配置ExternalProject_Add #

在你的项目根CMakeLists.txt中添加以下配置，替换默认的构建逻辑：

include(ExternalProject)

# 定义HDiffPatch外部项目
ExternalProject_Add(
    hdiffpatch_external
    GIT_REPOSITORY https://github.com/sisong/HDiffPatch.git
    GIT_TAG master  # 建议指定具体版本，比如v4.6.0
    PREFIX ${CMAKE_CURRENT_BINARY_DIR}/hdiffpatch
    CONFIGURE_COMMAND ""  # 跳过CMake配置步骤
    BUILD_COMMAND make -C <SOURCE_DIR>/libHDiffPatch  # 仅编译库模块，跳过工具程序
    INSTALL_COMMAND ""  # 无需安装，跳过install步骤
    BUILD_IN_SOURCE ON  # 在源码目录内构建，适配Makefile的相对路径依赖
)

# 获取HDiffPatch的源码路径，导入头文件和库
ExternalProject_Get_Property(hdiffpatch_external SOURCE_DIR)
set(HDiffPatch_INCLUDE_DIRS ${SOURCE_DIR}/libHDiffPatch)
set(HDiffPatch_LIBRARIES ${SOURCE_DIR}/libHDiffPatch/libhdiffpatch.a)  # 静态库路径

# 确保HDiffPatch先构建完成，再编译你的Qt项目
add_dependencies(你的Qt项目目标名 hdiffpatch_external)

# 链接HDiffPatch到你的项目
target_include_directories(你的Qt项目目标名 PRIVATE ${HDiffPatch_INCLUDE_DIRS})
target_link_libraries(你的Qt项目目标名 PRIVATE ${HDiffPatch_LIBRARIES})

关键配置说明 #

• CONFIGURE_COMMAND ""：禁用默认的CMake配置流程，避免查找CMakeLists.txt
• BUILD_COMMAND make -C <SOURCE_DIR>/libHDiffPatch：直接调用make，仅编译libHDiffPatch子目录的库代码，无需编译根目录的工具程序
• BUILD_IN_SOURCE ON：适配HDiffPatch Makefile的相对路径依赖，在源码目录内执行构建
• add_dependencies：保证你的项目在HDiffPatch编译完成后再构建，避免链接时找不到库文件

调用HDiffPatch功能示例 #

在你的C++代码中直接包含头文件调用核心功能：

#include "HDiff/diff.h"
#include "HPatch/patch.h"

// 生成差异文件
bool generateDiff(const std::string& oldFile, const std::string& newFile, const std::string& diffFile) {
    return CreateDiffData(oldFile.c_str(), newFile.c_str(), diffFile.c_str(), nullptr);
}

// 应用补丁文件
bool applyPatch(const std::string& oldFile, const std::string& diffFile, const std::string& newFile) {
    return PatchFile(oldFile.c_str(), diffFile.c_str(), newFile.c_str(), nullptr);
}

注意事项 #

• Windows环境下需使用MinGW或MSYS2的make工具，若用MSVC可改用HDiffPatch提供的VS工程文件，重新调整BUILD_COMMAND
• 若需要动态库，需修改HDiffPatch的Makefile添加-fPIC等编译选项，再将HDiffPatch_LIBRARIES改为动态库路径

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