APK如何做到200KB?完整揭秘Median的R8+raw-DEFLATE预压缩+v2签名打包管线
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
在谈管线之前,先明白"为什么小",这是整个打包策略的地基:
- 不打包内核 —— 渲染交给 Android 系统 WebView,省掉最大的 Chromium 内核(见 README.md 技术架构表)。
- 零第三方运行时依赖 —— app/build.gradle 的
dependencies里只有testImplementation,没有任何implementation库;tools/static_checks.sh 甚至会主动扫描并拒绝任何implementation依赖混入。 - 只搬运一小片 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 可查的版本记录里。