APK如何做到200KB?完整揭秘Median的R8+raw-DEFLATE预压缩+v2签名打包管线

原创2026-11-09 18:52:542,254 阅读

APK如何做到200KB?完整揭秘Median的R8+raw-DEFLATE预压缩+v2签名打包管线

Median 是一个安装包仅约 200 KB 的极致轻量化 Android 浏览器:不打包渲染内核、零第三方运行时依赖。这篇文章完整揭秘它的 APK 打包管线——从 R8 代码压缩、raw-DEFLATE 预压缩,到只启用 v2 签名并剥离签名块 padding 的每一步,全部基于仓库内真实脚本,新手也能看懂。

📊 先看数据:Median 的 APK 到底有多大

版本 APK 大小 说明
2.2.5 / 2.2.4 207,317 字节(约 202 KiB) 曾长期保持的最小值,见 CHANGELOG.md
2.3.0(当前) 219,605 字节(约 214 KiB) 新增密码自动填充等功能后的体积
发布预算 ≤ 350,000 字节 超过即构建失败

普通浏览器 APK 普遍在数十 MB 起步,而 Median 连 350 KB 的"发布预算" 都被当作硬性门禁。预算校验就在 tools/build_500kb_apk.sh 结尾:超出 MAX_APK_BYTES 直接 exit 3。

📉 体积第一刀:零运行时依赖 + 系统 WebView

在谈管线之前,先明白"为什么小",这是整个打包策略的地基:

  1. 不打包内核 —— 渲染交给 Android 系统 WebView,省掉最大的 Chromium 内核(见 README.md 技术架构表)。
  2. 零第三方运行时依赖 —— app/build.gradle 的 dependencies 里只有 testImplementation,没有任何 implementation 库;tools/static_checks.sh 甚至会主动扫描并拒绝任何 implementation 依赖混入。
  3. 只搬运一小片 WebView API —— 用户脚本的 document-start 桥接按 Chromium support-library boundary 协议,只 vendor 了 WebViewCompat / WebViewFeature / ScriptHandler 这几个类,而不是完整 AndroidX WebKit,设计说明见 WEBKIT_COMPATIBILITY.md。

💡 体积优化的顺序是:先砍内容(依赖/内核),再压代码(R8),最后抠字节(raw-DEFLATE 与签名)。

🏭 完整打包管线:build_500kb_apk.sh 的 7 个阶段

主脚本 tools/build_500kb_apk.sh 绕开了 Gradle 打包环节,用 aapt2 + javac + R8 直接拼出一条最短路径。发布签名入口 tools/build_signed_update.sh 从签名备份 zip 中读取密钥环境变量后,最终也调用同一条管线,保证同一份代码只有一种打包方式。

阶段 1:aapt2 资源编译 + 稀疏资源表

tools/build_500kb_apk.sh#L44-L58 中 aapt2 link 开启了 --enable-sparse-encoding(稀疏编码资源表,Android 7+ 可省资源表体积),并直接锁定 min-sdk 26 / target-sdk 36,同时通过 --proguard 导出 aapt2 生成的 keep 规则供 R8 复用。

阶段 2:javac 手动编译 + 自建 BuildConfig

脚本用 javac -source 17 -target 17 一次性编译 app/src/main/java 全部源码、aapt2 生成的 R 类和手写的 BuildConfig.java(build_500kb_apk.sh#L60-L77),跳过 Gradle 的增量编译开销,产物确定、可复现。

阶段 3:打包前先跑完 22 个自测

在压缩之前,脚本会编译并运行 tools/tests/ 下的 22 个 *SelfTest(下载策略、主页配置、媒体探测、凭据自动填充等),再用 node --check 校验生成给 WebView 注入的 JavaScript(build_500kb_apk.sh#L103-L139)。先保证功能完整,再谈压缩,避免"压完才发现崩了"。

阶段 4:直接调用 R8,只为 6 个入口类写 keep 规则

R8 调用见 tools/build_500kb_apk.sh#L163-L170:--release --min-api 26 全量优化。keep 配置(build_500kb_apk.sh#L142-L158)非常克制——只固定 Manifest 里 6 个入口类的类名和构造器(MainActivity、PrivateActivity、DownloadCenterActivity、AdaptiveDownloadService 及两个 ContentProvider),全部使用 -keep,allowoptimization,其余方法、字段交给 R8 随意改名、内联、删除:

-keep,allowoptimization class com.xinyv.median.MainActivity { public <init>(); }
# ... 其余 5 个入口类同理
-keep,allowoptimization interface org.chromium.support_lib_boundary.** { *; }

另外两条全局规则 -overloadaggressively 和 -allowaccessmodification 允许 R8 复用重载方法、放开访问级别,进一步压缩字节码。WebView 反射调用的 boundary 接口名则通过 keepnames 保护,细节见 app/proguard-rules.pro 与 WEBKIT_COMPATIBILITY.md。

注:早期实验过 -repackageclasses(R8 类重打包)和 Zopfli 压缩器,实测无收益或引入不确定性后已撤回,构建只保留原始 raw-DEFLATE 路径(见 CHANGELOG.md)。

阶段 5:raw-DEFLATE 预压缩——为 classes.dex 找"最小的一条压缩流"

这是 Median 最有特色的一步。R8 产出的 classes.dex 先用 zip -9 写入 APK,随后立刻被两个 Python 工具"换血":

① 搜索最优压缩流 — tools/deflate_raw.py 并不满足于"压缩一次",而是批量试探:

  • zlib:压缩级别 6~9 × memLevel 5~9,共 20 组(memLevel 会改变匹配查找结构,DEX 文件常常在默认值以下压得更小,见源码注释 deflate_raw.py#L56-L57);
  • 构建机装有 libdeflate 时,追加其 10~12 级更高密度压缩(deflate_raw.py#L10-L46);
  • 在所有候选中取字节数最小的那条 raw-DEFLATE 流。

② 手工重写 ZIP — tools/repack_precompressed.py 先验证预压缩流解压后与原条目逐字节一致(zlib.decompress(replacement, -15) != data 即报错),然后按最紧凑的布局逐字节写出本地文件头、中央目录和 EOCD(repack_precompressed.py#L46-L69)。同时脚本还先执行 touch -t 198001010000 classes.dex(build_500kb_apk.sh#L173)把时间戳钉死在 1980-01-01,让每次构建产物逐字节可复现。

阶段 6:zipalign 对齐 + 只启用 v2 签名

zipalign -f -p 4 完成 4 字节页对齐后(build_500kb_apk.sh#L181),apksigner sign 的签名开关是关键(build_500kb_apk.sh#L183-L193):

--v1-signing-enabled false
--v2-signing-enabled true
--v3-signing-enabled false
--v4-signing-enabled false

v1(JAR 签名)要往每个条目里塞 .SF/.RSA 文件,v3/v4 还会追加额外结构;而 v2 签名只写一个 APK Signing Block,对 Android 8+(Median 最低支持 API 26)完全够用,一份签名就省下几十 KB 的重复签名开销。同样的开关也写进了 Gradle 的 release 配置 app/build.gradle#L34-L37,保证两条构建路径签名行为一致。

阶段 7:连签名块的 padding 也要剥掉

apksigner 为了让 v2 签名块大小对齐,会在块内写一段可选的 verity padding(块内 ID 为 0x42726577)。tools/strip_apk_signing_padding.py 解析 "APK Sig Block 42" 签名块,只移除这个 padding 对并重写块长度与中央目录偏移,不触碰任何真实签名数据,签名依然有效——最后一厘米的空间也抠出来了。

🚦 发布门禁:校验与确定性

签名完成后还有一整套"出厂检验"(build_500kb_apk.sh#L196-L200):

  • apksigner verify --verbose 复验签名并导出证书;
  • aapt dump badging 校验包元信息;
  • unzip -t 检查 ZIP 完整性(证明手工重写的 ZIP 没写坏);
  • 用 DownloadFileTypesSelfTest 直接打开最终 APK 做类型识别测试;
  • 生成 .sha256 文件供分发校验。

配合 tools/static_checks.sh(版本一致性、无新依赖、无弱口令证书)与 tools/verify.sh(Gradle lint + 单测 + AAB),整条管线做到了:每次构建字节级可复现、体积超预算即失败、签名只有一份。

📁 关键文件路径速查

文件 作用
tools/build_500kb_apk.sh 200 KB 级 APK 的主打包管线(aapt2 → javac → R8 → 预压缩 → v2 签名)
tools/build_signed_update.sh 从签名备份注入密钥后走同一条管线出正式包
tools/deflate_raw.py zlib + libdeflate 双路搜索最小 raw-DEFLATE 流
tools/repack_precompressed.py 校验后把预压缩流写回 ZIP 并紧凑重写表头
tools/strip_apk_signing_padding.py 移除 v2 签名块内的 verity padding
tools/static_checks.sh 静态门禁:禁止第三方运行时依赖等
app/build.gradle Gradle 路径同样开启 minifyEnabled + shrinkResources 与 v2-only 签名
app/proguard-rules.pro boundary 接口与 JavascriptInterface 的 keep 规则
WEBKIT_COMPATIBILITY.md 只搬运 WebView API 薄片的设计说明
CHANGELOG.md 每个版本的 APK 字节数记录

✅ 一句话总结

Median 的 200 KB 不是某一个技巧的功劳,而是一条纪律完整的管线:先砍到零依赖的地基 → R8 只保 6 个入口类的全量优化 → 为 classes.dex 穷举搜索最小 raw-DEFLATE 流 → v2 单签名 + 剥离签名块 padding → 350 KB 预算门禁 + 字节级可复现。每一步省下的字节,都写进了 CHANGELOG.md 可查的版本记录里。

登录后查看全文
Median