Archive-Patcher 使用教程

2026-01-19 11:29:05作者：农烁颖Land

1、项目介绍

Archive-Patcher 是一个开源项目，旨在实现对 ZIP 归档文件的空间高效修补。该项目允许用户在不完全解压 ZIP 文件的情况下，对其进行修改和更新，从而节省存储空间和带宽。Archive-Patcher 通过生成和应用增量补丁来实现这一功能，这些补丁仅包含必要的更改，而不是整个文件的副本。

2、项目快速启动

环境准备

确保你已经安装了 Java 开发环境（JDK）和一个 Git 客户端。

克隆项目

首先，克隆 Archive-Patcher 项目到本地：

git clone https://github.com/andrewhayden/archive-patcher.git
cd archive-patcher

生成补丁

以下是一个简单的示例，展示如何生成一个补丁文件：

import com.google.archivepatcher.generator.FileByFileV1DeltaGenerator;
import com.google.archivepatcher.shared.DefaultDeflateCompatibilityWindow;
import java.io.File;
import java.io.FileOutputStream;
import java.util.zip.Deflater;
import java.util.zip.DeflaterOutputStream;

public class SamplePatchGenerator {
    public static void main(String[] args) throws Exception {
        if (!new DefaultDeflateCompatibilityWindow().isCompatible()) {
            System.err.println("zlib not compatible on this system");
            System.exit(-1);
        }
        File oldFile = new File(args[0]); // 必须是 ZIP 归档文件
        File newFile = new File(args[1]); // 新的 ZIP 归档文件
        File patchFile = new File(args[2]); // 补丁文件

        FileOutputStream fos = new FileOutputStream(patchFile);
        DeflaterOutputStream dos = new DeflaterOutputStream(fos, new Deflater(Deflater.DEFAULT_COMPRESSION));
        FileByFileV1DeltaGenerator.generateDelta(oldFile, newFile, dos);
        dos.close();
    }
}

应用补丁

以下是一个简单的示例，展示如何应用一个补丁文件：

import com.google.archivepatcher.applier.FileByFileV1DeltaApplier;
import java.io.File;
import java.io.FileInputStream;
import java.util.zip.InflaterInputStream;

public class SamplePatchApplier {
    public static void main(String[] args) throws Exception {
        File oldFile = new File(args[0]); // 原始 ZIP 归档文件
        File patchFile = new File(args[1]); // 补丁文件
        File newFile = new File(args[2]); // 新的 ZIP 归档文件

        FileInputStream fis = new FileInputStream(patchFile);
        InflaterInputStream iis = new InflaterInputStream(fis);
        FileByFileV1DeltaApplier.applyDelta(oldFile, iis, newFile);
        iis.close();
    }
}