HDiffPatch 项目使用教程

HDiffPatch 项目使用教程

HDiffPatch a C\C++ library and command-line tools for Diff & Patch between binary files or directories(folder); cross-platform; runs fast; create small delta/differential; support large files and limit memory requires when diff & patch. 项目地址: https://gitcode.com/gh_mirrors/hd/HDiffPatch

1. 项目目录结构及介绍

HDiffPatch 项目的目录结构如下：

HDiffPatch/
├── builds/
│   ├── android_ndk_jni_mk/
│   ├── vc/
│   └── ...
├── dirDiffPatch/
├── libHDiffPatch/
├── libParallel/
├── libhsync/
├── test/
├── vcdiff_wrapper/
├── bsdiff_wrapper/
├── .gitignore
├── CHANGELOG.md
├── LICENSE
├── Makefile
├── README.md
├── README_cn.md
└── ...

目录介绍

• builds/: 包含不同平台的构建脚本和配置文件，如 Android NDK 的 JNI 配置、Visual Studio 的项目文件等。
• dirDiffPatch/: 包含用于目录差异和补丁的工具和库。
• libHDiffPatch/: 核心库，提供二进制文件和目录的差异和补丁功能。
• libParallel/: 并行处理库，用于加速差异和补丁的计算。
• libhsync/: 同步库，用于实现文件的增量更新。
• test/: 测试目录，包含项目的测试用例和测试数据。
• vcdiff_wrapper/: VCDIFF 格式的封装库。
• bsdiff_wrapper/: BSDIFF 格式的封装库。
• .gitignore: Git 忽略文件配置。
• CHANGELOG.md: 项目更新日志。
• LICENSE: 项目许可证。
• Makefile: 项目的 Makefile，用于构建项目。
• README.md: 项目的英文介绍文档。
• README_cn.md: 项目的中文介绍文档。

2. 项目启动文件介绍

HDiffPatch 项目的主要启动文件是 Makefile，它位于项目根目录下。Makefile 包含了项目的构建规则和依赖关系，可以通过以下命令启动项目的构建：

$ make

主要构建目标

• all: 默认目标，构建所有组件。
• clean: 清理构建生成的文件。
• test: 运行测试用例。

3. 项目配置文件介绍

HDiffPatch 项目的配置文件主要集中在 builds/ 目录下，不同平台的配置文件有所不同。

Android 配置

在 builds/android_ndk_jni_mk/ 目录下，包含 Android NDK 的 JNI 配置文件和构建脚本。可以通过以下命令进行构建：

$ cd builds/android_ndk_jni_mk
$ build_libs.sh

Windows 配置

在 builds/vc/ 目录下，包含 Visual Studio 的项目文件 HDiffPatch.sln。可以通过 Visual Studio 打开该文件进行项目的构建和配置。

Linux/MacOS 配置

在项目根目录下的 Makefile 文件中，包含了 Linux 和 MacOS 的构建配置。可以通过以下命令进行构建：

$ make LDEF=0 LZMA=0 ZSTD=0 MD5=0

其他配置

项目还依赖于一些外部库，如 libmd5、lzma、zstd 等。这些库的源码可以通过以下命令获取并构建：

$ git clone https://github.com/sisong/libmd5.git
$ git clone https://github.com/sisong/lzma.git
$ git clone https://github.com/sisong/zstd.git
$ git clone https://github.com/sisong/zlib.git
$ git clone https://github.com/sisong/libdeflate.git

通过以上配置，可以完成 HDiffPatch 项目的构建和使用。

HDiffPatch a C\C++ library and command-line tools for Diff & Patch between binary files or directories(folder); cross-platform; runs fast; create small delta/differential; support large files and limit memory requires when diff & patch. 项目地址: https://gitcode.com/gh_mirrors/hd/HDiffPatch