87 lines
2.3 KiB
Markdown
87 lines
2.3 KiB
Markdown
# apkdiff
|
||
|
||
APK 增量更新模块，基于 [bsdiff](https://github.com/mendsley/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：
|
||
|
||
```bash
|
||
cmake -B gen/build -S gen -G "Visual Studio 18 2026" -A x64
|
||
cmake --build gen/build --config Release
|
||
```
|
||
|
||
## gen.exe 用法
|
||
|
||
```bash
|
||
gen.exe <old.apk> <new.apk> <output.patch>
|
||
```
|
||
|
||
## JNI 编译（Android NDK）
|
||
|
||
```bash
|
||
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 端使用
|
||
|
||
```kotlin
|
||
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)
|