QZMusic/apkdiff/README.md

apkdiff

APK 增量更新模块，基于 bsdiff + zlib + minizip。

通过对比新旧 APK 中每个文件的内容差异，生成体积远小于完整 APK 的 patch 文件，在设备端应用 patch 生成新 APK。

结构

├── bsdiff.c / bsdiff.h     # bsdiff 核心算法（原库，未修改）
├── bspatch.c / bspatch.h   # bspatch 核心算法（原库，未修改）
├── common/
│   ├── patch_format.h      # Patch 文件格式定义
│   └── zlib_stream.h/.c    # zlib 压缩/解压，适配 bsdiff/bspatch stream
├── gen/
│   ├── CMakeLists.txt      # 构建 gen.exe
│   └── main.c              # Patch 生成工具入口
├── jni/
│   ├── CMakeLists.txt      # NDK CMake 构建
│   ├── Android.mk          # 备选 ndk-build 构建
│   ├── Application.mk      # NDK 配置
│   ├── apkpatch.c          # JNI native 实现
│   └── Patcher.kt          # Kotlin 包装类
└── third_party/
    └── zlib/               # zlib 源码（作为 submodule 或直接包含）

Patch 文件格式

Header:
  [16B]  Magic "APKDIFF/1.0\0\0\0"
  [4B]   uint32_t entry_count

Entry (×entry_count):
  [2B]   uint16_t path_len
  [NB]   path
  [1B]   type  (0=PATCH, 1=NEW, 2=COPY)
  [8B]   int64_t old_size
  [8B]   int64_t new_size
  [4B]   uint32_t compressed_size
  [NB]   zlib compressed data (COPY 时无数据)

gen.exe 编译（Windows）

需要 MSVC + CMake：

cmake -B gen/build -S gen -G "Visual Studio 18 2026" -A x64
cmake --build gen/build --config Release

gen.exe 用法

gen.exe <old.apk> <new.apk> <output.patch>

JNI 编译（Android NDK）

cmake -B jni/build/arm64-v8a -S jni \
  -G "Unix Makefiles" \
  -DCMAKE_TOOLCHAIN_FILE=<NDK>/build/cmake/android.toolchain.cmake \
  -DANDROID_ABI=arm64-v8a \
  -DANDROID_PLATFORM=android-21 \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_MAKE_PROGRAM=<NDK>/prebuilt/windows-x86_64/bin/make.exe

make -C jni/build/arm64-v8a -j8

Android 端使用

import love.qz.apkpatcher.Patcher

val oldApk = context.applicationInfo.sourceDir
val result = Patcher.applyPatch(oldApk, patchPath, newApkPath)
// result == 0 → 成功

License

BSD 2-Clause (bsdiff/bspatch), zlib License (zlib/minizip)