07.1.1.11.3 包体、混淆、签名、CI 与上架
所属:全栈开发面试题库 / 07 端侧与桌面开发 / 07.1 原生移动开发 / 07.1.1 Android / 07.1.1.11 性能、稳定性与工程化
本节要解决的问题
本节从工程化交付角度出发:梳理 R8 的收缩、混淆、优化与 keep 规则,说明 mapping 管理与堆栈还原;分析包体构成、资源压缩、ABI 与分包;覆盖签名方案 v1/v2/v3/v4 与密钥管理、多渠道打包;最后说明 CI 流水线、构建缓存与上架合规要求。版本基线:AGP 8.x、R8、Android 14 / compileSdk 34;版本敏感行为标「待确认」并写明验证点。
07.1.1.11.3-001 R8 的收缩、混淆、优化分别做什么?
一句话结论
R8 在构建期完成三件事:shrink(收缩未被引用的代码)、obfuscate(混淆重命名类/方法/字段)、optimize(优化代码结构);三者共同减小包体并提升一定运行效率。
概念解释
- 收缩:从入口点出发分析可达性,移除未引用的类、方法、字段。
- 混淆:把可混淆符号重命名为短名,减小体积并增加逆向难度。
- 优化:内联、常量传播、无用分支移除、类/方法重排等。
R8 替代了旧版 ProGuard 的角色,在 AGP 构建期运行。三者相互影响:收缩依赖可达性分析,混淆依赖 keep 规则保留必要符号。具体优化项随 R8 版本演进(待确认)。
原理流程
编译产物 → 可达性分析(收缩)
→ 代码优化(优化)
→ 符号重命名(混淆) → 输出 dex + mapping
代码或图示
输入:class 字节码;输出:优化后 dex + mapping.txt
常见误区
- 以为 R8 只做混淆;收缩与优化同样影响包体与行为。
- 混淆后运行崩溃,多为 keep 规则缺失导致被收缩/改名。
追问
- R8 在哪个构建阶段运行?答:打包 dex 前的代码处理阶段,随 AGP 构建流程执行。
- 收缩误删代码的常见原因?答:反射/动态调用未被可达性分析识别,需 keep 保留。
07.1.1.11.3-002 R8 与 ProGuard 是什么关系?
一句话结论
R8 是 AGP 默认使用的现代代码压缩混淆工具,取代 ProGuard;兼容 ProGuard 规则语法,但在收缩、优化与 dex 输出上做了合并与改进。
概念解释
旧项目可能保留 ProGuard 配置文件与规则写法。R8 读取同类 keep 规则,直接输出 dex 而非先输出 jar 再 dx。规则大体兼容,但个别 ProGuard 高级特性在 R8 下行为有差异。新项目以 R8 为准,配置文件仍常命名为 proguard-rules.pro。具体兼容差异以 AGP/R8 版本文档为准(待确认)。
原理流程
ProGuard 时代:压缩混淆 → jar → dx
R8 时代:分析优化混淆 → 直接 dex
代码或图示
规则文件:proguard-rules.pro,R8 读取执行
常见误区
- 以为还需要单独接入 ProGuard 插件;AGP 内置 R8。
- 照搬旧 ProGuard 经验,未核对 R8 行为差异。
追问
- R8 规则文件和 ProGuard 一样写吗?答:keep 规则语法基本兼容,高级选项差异需核对文档。
- 如何确认构建用的是 R8?答:AGP 8.x 默认 R8,构建日志与产物可核对(待确认)。
07.1.1.11.3-003 如何在构建中启用 R8 收缩与混淆?
一句话结论
在构建变体配置中开启 minifyEnabled(收缩+混淆+优化),资源压缩由 shrinkResources 配合;release 变体开启,debug 通常关闭便于调试。
概念解释
minifyEnabled true 启用 R8 代码收缩混淆;shrinkResources true 移除未引用资源,需配合 minify。debug 关闭以保留可读符号与加速构建。变体区分:release 开启优化,debug 保留调试信息。开启后必须配套 keep 规则与 mapping 归档。具体 DSL 属性名以 AGP 版本为准(待确认)。
原理流程
buildTypes.release {
minifyEnabled = true
shrinkResources = true
}
代码或图示
android {
buildTypes {
release {
isMinifyEnabled = true
isShrinkResources = true
proguardFiles(...)
}
}
}
常见误区
- debug 也开混淆,调试堆栈不可读、构建变慢。
- 只开 shrinkResources 不开 minify,资源压缩不生效。
追问
- minify 与 shrinkResources 必须一起开吗?答:资源压缩依赖代码收缩结果,通常配合开启。
- 关闭 minify 的 release 包有何风险?答:包体大、符号未混淆,且未做可达性收缩。
07.1.1.11.3-004 收缩如何判定代码是否可达?
一句话结论
R8 从入口点(入口类、被保留项、反射/清单声明等)出发做引用可达性分析,不可达的类/方法/字段判定为可移除;动态调用若未被识别则可能被误删。
概念解释
可达性分析沿引用关系遍历:入口点包括 Application、四大组件、JNI 方法、keep 保留项等。分析不到的动态调用(反射、注解扫描、动态代理、JS 桥)可能被判定不可达而收缩。keep 规则显式保留这些入口。分析结果决定哪些代码进入最终 dex。
原理流程
入口点集合 → 引用遍历
→ 可达代码保留 / 不可达候选移除
代码或图示
入口:组件 / JNI / keep / 清单声明
常见误区
- 反射调用的方法未 keep,被收缩后运行找不到。
- 以为所有被调用代码都可达;动态调用不在静态分析视野内。
追问
- 如何发现被误删的代码?答:release 包运行反射/动态路径崩溃,结合 mapping 与 keep 规则排查。
- 入口点从哪里识别?答:Manifest 组件、JNI 导出、keep 规则与框架约定入口。
07.1.1.11.3-005 混淆对类、方法、字段做了什么?
一句话结论
混淆把可混淆的类名、方法名、字段名重命名为短名(如 a、b),减小符号体积并增加逆向难度;被 keep 的符号保持原名。
概念解释
重命名在不改变行为的前提下压缩标识符。包名/类名缩短,方法字段改为短名,内部结构被打乱。入口与 keep 项不改名。混淆后堆栈、反射、序列化按原名查找会失败,需 mapping 还原或 keep 保留。混淆不删除代码(那是收缩职责),只改命名。
原理流程
符号分析 → 可混淆项重命名
→ keep 项保留原名
→ 记录原名-短名映射到 mapping
代码或图示
com.example.Order → a;submit() → b()
常见误区
- 混淆把序列化字段名改了,反序列化失败。
- 反射按原名调用混淆后方法,找不到符号。
追问
- 混淆能防止反编译吗?答:提高阅读门槛,不能完全防止;逆向仍可结合 mapping 与行为分析。
- 哪些符号不能改名?答:反射引用、序列化字段、JNI 方法、JS 桥接口等需 keep。
07.1.1.11.3-006 R8 优化包含哪些常见手段?
一句话结论
优化包括方法内联、常量传播、无用分支/参数移除、类与方法合并重排等,在不改变行为前提下减少指令与调用开销;优化可能改变栈结构,需与 mapping 还原配合。
概念解释
优化在收缩混淆之间进行:短小方法内联减少调用开销,常量折叠传播,不可达分支移除,部分类/字段合并。优化使代码更紧凑,但内联后堆栈帧与源码行号对应关系需 mapping 记录。过度优化在个别场景可能触发行为差异,需 release 测试验证。具体优化项以 R8 版本为准(待确认)。
原理流程
字节码 → 内联/常量传播/死分支移除
→ 结构合并重排 → 输出优化 dex
代码或图示
优化项:inline / constant propagation / dead branch / merge
常见误区
- 优化后崩溃栈行号对不上,误以为 mapping 错误。
- 依赖特定方法/类结构的反射被优化破坏。
追问
- 优化会影响运行性能吗?答:合理优化减少调用与指令,个别场景需实测;主要收益在包体。
- 如何关闭某项优化?答:按 R8 规则配置,具体选项以文档为准(待确认)。
07.1.1.11.3-007 keep 规则语法有哪些常用形式?
一句话结论
keep 规则按「保留类/成员、保留名称、保留成员」组合使用:-keep 保留类与成员不收缩不改名,-keepnames 仅保留名称,-keepclassmembers 保留类内成员。
概念解释
常用规则:
-keep class X:保留类及其成员。-keep class X { <methods>; }:保留指定成员。-keepnames:未被收缩时保留原名。-keepclassmembers:保留成员,类本身可被处理。
通配符匹配类名/成员。规则要精确,避免过宽保留过多代码削弱收缩效果。规则来源:项目自身、第三方库 consumer 规则、默认配置。
原理流程
规则匹配类/成员
→ 标记保留(不收缩/不改名)
→ 其余参与收缩混淆
代码或图示
-keep class com.example.model.** { *; }
-keepclassmembers class * { @keep <methods>; }
常见误区
- 规则过宽
** { *; }保留大量代码,包体收益下降。 - 只 keep 类名,未 keep 被反射调用的方法/字段。
追问
- keep 与 keepnames 区别?答:keep 阻止收缩与改名;keepnames 仅在类被保留时保留名称。
- 第三方库规则从哪来?答:库 consumer ProGuard 规则随依赖带入,项目规则补充。
07.1.1.11.3-008 反射调用的类/方法如何写 keep?
一句话结论
反射按类名/方法名/字段名动态查找的目标必须 keep 保留名称与成员,否则混淆改名或收缩后反射找不到;规则按反射使用的类型精确保留。
概念解释
反射在运行期按字符串名字加载类、取方法/字段,静态分析识别不到。需 keep:反射加载的类、调用的方法、访问的字段。常见:序列化框架、注解处理器、依赖注入、路由框架、工具类反射。规则要覆盖反射目标签名。混淆后调试反射失败先查 keep 是否缺失。
原理流程
反射 Class.forName("X") / getMethod("m")
→ keep X 与 m 保留原名
→ 运行期按名查找成功
代码或图示
-keep class com.example.ReflectTarget {
public void reflectMethod();
public java.lang.String field;
}
常见误区
- keep 了类,方法/字段仍被改名。
- 反射调用私有方法/内部类未纳入规则。
追问
- 泛型反射目标如何匹配?答:按实际反射的类签名写规则,通配符谨慎使用。
- 如何排查反射类被删?答:release 崩溃类/方法找不到,对照反射调用点补 keep。
07.1.1.11.3-009 序列化数据模型为什么要 keep?
一句话结论
序列化/反序列化依赖字段名与类型映射,模型类字段需保留名称,否则混淆改名后 JSON/序列化无法按字段名还原。
概念解释
JSON 序列化、kotlinx.serialization、Gson/Moshi 等按字段名读写。混淆改字段名后,解析期望原名字段失败。keep 规则保留模型字段名;部分框架自带 consumer 规则。模型类的方法/构造按框架要求保留。新增模型字段需检查规则覆盖。
原理流程
JSON 字段名 ↔ 模型字段
→ 字段名被 keep 保留
→ 序列化/反序列化映射成功
代码或图示
-keep class com.example.model.** { <fields>; }
常见误区
- 只 keep 类名,字段被改名导致解析丢字段。
- 新增嵌套模型类未纳入模型包规则。
追问
- 枚举序列化也要 keep 吗?答:按框架名称映射要求,枚举常量名可能需保留(待确认框架规则)。
- 混淆字段名对序列化有何具体表现?答:解析后字段为空或抛类型/缺失异常。
07.1.1.11.3-010 JS 桥与接口调用为何需要 keep?
一句话结论
WebView JS 桥、Native 暴露给前端的接口方法按名称被 JavaScript 调用,需 keep 保留方法名;否则混淆后前端调用找不到对应原生方法。
概念解释
JS 通过注解或桥注册调用原生方法,调用按方法名匹配。混淆改名后桥注册映射失效,前端调用无响应或报错。keep 保留桥接口类与被注解方法。跨端约定的方法名不能被混淆。WebView 桥安全与风险见 WebView 章节。
原理流程
JS 调用 bridge.methodName()
→ 原生按名查找方法
→ keep 保留 methodName
代码或图示
-keep class com.example.jsbridge.** {
@android.webkit.JavascriptInterface <methods>;
}
常见误区
- 桥接口方法被混淆,前端调用静默失败。
- 只保留主桥类,暴露的子方法/回调未 keep。
追问
- 桥注解在不同框架一致吗?答:原生 WebView 与混合框架注解不同,按实际桥实现核对规则(待确认)。
- 如何验证桥规则生效?答:release 包走前端调用用例,确认方法可达。
07.1.1.11.3-011 JNI 原生方法为什么必须 keep?
一句话结论
JNI 方法由原生代码按 Java 类名/方法名查找,类与 native 方法名必须保留;混淆改名后原生层找不到对应方法,链接或调用失败。
概念解释
原生代码通过 JNI 按全限定类名与方法名注册/查找 Java 方法。混淆改类名、方法名后,JNI 符号映射对不上,表现为加载库或调用时找不到方法。keep 保留含 native 方法的类与方法名。静态注册与动态注册对命名的依赖不同,规则按注册方式核对。
原理流程
原生层按名查找 Java native 方法
→ 类/方法名 keep 保留
→ JNI 链接成功
代码或图示
-keep class com.example.NativeBridge {
native <methods>;
}
常见误区
- native 方法所在类被混淆改名,原生注册失败。
- 动态注册类名变化未纳入规则。
追问
- 动态注册还依赖方法名吗?答:动态注册在代码里显式绑定,类名仍需核对,具体方式待确认。
- JNI 崩溃栈如何关联 Java 层?答:结合 Native 符号表与 Java 栈,见稳定性章节。
07.1.1.11.3-012 枚举、注解、泛型元数据为何有时要 keep?
一句话结论
枚举常量名、注解类型、泛型签名等在反射、框架扫描、序列化中按名称读取,混淆/移除元数据会导致框架识别失败;按框架需要保留对应成员与属性。
概念解释
- 枚举:常量名被序列化或反射读取时需保留。
- 注解:运行期保留的注解被扫描,注解类与属性不能被移除。
- 泛型/签名:部分框架读取泛型信息做解析,签名属性需保留。
具体哪些元数据必须保留取决于所用框架,框架通常自带规则。不确定时在 release 包验证框架路径。元数据保留会增加少量体积。
原理流程
框架运行期扫描注解/枚举/泛型
→ 对应名称与元数据 keep 保留
代码或图示
-keepattributes *Annotation*, Signature, Enumeration
常见误区
- 移除注解属性后,依赖注解的框架初始化失败。
- 枚举常量被改名,按名匹配分支失效。
追问
-keepattributes保留什么?答:保留注解、签名、内部类等属性信息,具体项按框架需求(待确认)。- 泛型擦除后签名还有用吗?答:局部签名属性可供反射读取,框架需要时保留。
07.1.1.11.3-013 keep 规则编写有哪些常见踩坑?
一句话结论
常见坑:规则过宽削弱收缩、只 keep 类不 keep 成员、第三方库规则缺失、新增类未纳入包规则、内部类/泛型通配符匹配不全;规则需随代码评审维护。
概念解释
踩坑清单:
- 过宽:
** { *; }保留过多,包体收益低。 - 成员遗漏:类保留了,反射方法/字段被改名。
- 内部类:外部类规则未覆盖嵌套类。
- 通配符:
*与**匹配层级理解错误。 - 新模型/桥接口未补规则。
规则评审与 release 回归结合,避免上线后动态路径崩溃。规则注释说明保留原因,便于维护。
原理流程
动态调用点(反射/序列化/桥/JNI)
→ 对应 keep 规则
→ 评审覆盖 + release 验证
代码或图示
检查:类 / 方法 / 字段 / 内部类 / 注解属性
常见误区
- 出问题才补规则,未在编码阶段识别动态调用。
- 复制通用模板规则,与自身代码不匹配。
追问
- 如何审查 keep 规则是否过宽?答:对照保留代码量与包体收益,收窄到实际动态调用目标。
- 第三方库自带规则在哪查看?答:依赖库的 consumer 规则文件,构建合并后可核对(待确认)。
07.1.1.11.3-014 混淆后的代码如何调试与查看日志?
一句话结论
release 混淆包调试依赖 mapping 还原堆栈,日志中打印的类/方法名为短名;本地用 debug 包复现,线上栈经符号化还原后定位源码。
概念解释
混淆包内符号是短名,日志直接阅读困难。调试策略:优先 debug 包复现可读栈;线上崩溃/ANR 栈用 mapping 符号化还原。日志避免打印依赖原名的信息。必要时为关键类保留名称便于排查。混淆不影响逻辑行为,只影响可读性。
原理流程
release 日志/堆栈(短名)
→ mapping 符号化还原
→ 对应源码定位
代码或图示
调试:debug 复现 + release 栈 mapping 还原
常见误区
- 在混淆包上直接读短名堆栈定位源码,效率低且易错。
- 日志打印敏感原名信息,混淆后仍暴露内部结构。
追问
- 能否为排查临时保留某类名?答:可对关键类 keepnames,但需评估包体与逆向风险。
- 行号在混淆后还准吗?答:mapping 记录行号映射,优化内联可能偏移,见后续题目。
07.1.1.11.3-015 mapping.txt 记录了什么,如何生成?
一句话结论
mapping.txt 记录混淆前后类名、方法名、字段名及行号映射,由 R8 在混淆构建时生成;是线上堆栈还原的必需文件。
概念解释
mapping 内容:原始类 → 混淆类、原始方法/字段 → 混淆名、行号对应关系。每次发布构建产出一份。文件随版本唯一对应,丢失则该版本混淆栈不可还原。mapping 属敏感产物,受控保存不随包分发。生成位置在构建输出目录,具体路径以 AGP 版本为准(待确认)。
原理流程
R8 混淆 → 记录原名/短名/行号
→ 输出 mapping.txt
代码或图示
com.example.X -> a:
void m() -> b
常见误区
- 以为 mapping 在运行期打包进 APK;它是构建期归档产物。
- 多次构建共用一份 mapping,版本对应错乱。
追问
- mapping 包含哪些映射粒度?答:类、方法、字段、行号,内联信息也可能记录。
- 如何确认 mapping 已生成?答:检查构建输出目录 mapping 文件并随版本归档。
07.1.1.11.3-016 mapping 如何按版本归档管理?
一句话结论
mapping 按 versionCode/版本名/变体/渠道归档到符号化服务或制品库,与发布版本一一对应;线上崩溃带版本号,符号化时取对应 mapping 还原。
概念解释
归档维度:版本名、版本号、构建变体、flavor、构建时间。每次发版上传对应 mapping,不可覆盖旧版本。符号化按崩溃上报的版本匹配归档文件。多变体/多渠道各自 mapping 需区分。mapping 访问受控,避免泄露内部结构。归档流程接入 CI 自动上传。
原理流程
发布构建 → 产出 mapping
→ 按版本归档上传
→ 崩溃栈 + 版本 → 匹配 mapping 还原
代码或图示
归档键:versionName / versionCode / buildType / flavor
常见误区
- 只保留最新 mapping,旧版本崩溃无法解析。
- 多变体共用归档键,错配还原。
追问
- mapping 何时上传?答:发布构建成功后、上架前自动归档,见 CI 章节。
- mapping 泄露有何风险?答:混淆保护被削弱,需受控访问。
07.1.1.11.3-017 混淆堆栈如何用 mapping 还原?
一句话结论
符号化工具读取对应版本 mapping,把混淆栈帧的短类名/方法名/行号反解为原始符号,输出可读堆栈;还原后再聚类定位源码。
概念解释
还原过程:崩溃栈帧短名 → 查 mapping 类映射 → 方法/字段映射 → 行号映射 → 原始栈帧。工具自动完成,开发看到可读栈。内联方法按 mapping 记录展开。还原依赖 mapping 与版本匹配。ANR 栈、崩溃栈走同一流程。
原理流程
混淆栈 + 版本 → 取 mapping
→ 类/方法/行号反解
→ 原始可读堆栈
代码或图示
a.b(Unknown:12) → com.example.X.method(X.kt:88)
常见误区
- 用错版本 mapping,还原到错误源码位置。
- 内联方法未正确展开,栈帧看起来缺失。
追问
- 还原后行号偏移怎么办?答:核对 mapping 版本与构建一致性,内联偏移按工具规则处理(待确认)。
- 第三方库混淆栈如何还原?答:用库自带 mapping 或未混淆符号处理。
07.1.1.11.3-018 代码重排与内联如何影响 mapping 与堆栈?
一句话结论
R8 内联方法、合并类、重排代码后,堆栈帧与行号按 mapping 记录的映射还原;内联会使调用链在栈中折叠,需结合 mapping 内联信息展开。
概念解释
优化把小方法内联到调用处,崩溃栈可能看不到被内联的独立方法帧;类合并后符号映射变化。mapping 记录这些变换与行号对应。还原工具据此恢复逻辑调用链。理解这一点可解释「源码里有方法但栈里没有」的现象。具体内联记录格式以 R8 版本为准(待确认)。
原理流程
内联/合并/重排
→ mapping 记录变换与行号
→ 符号化展开内联帧
代码或图示
栈帧折叠:被内联方法按 mapping 还原到调用处
常见误区
- 栈帧缺失就认为 mapping 错误,实际是内联折叠。
- 混淆后行号与源码不完全对应,未核对内联信息。
追问
- 如何减少内联对排查的影响?答:关键方法避免过小被内联,或保留必要栈帧(规则手段待确认)。
- 内联会改变崩溃行为吗?答:不改变逻辑,但改变栈形态与行号映射。
07.1.1.11.3-019 mapping 丢失或错配有什么后果?
一句话结论
mapping 丢失则该版本混淆堆栈无法还原为源码符号,只能按短名粗分;错配 mapping 会还原到错误类与行号,误导排查。
概念解释
丢失:线上崩溃栈保持短名,无法定位业务代码,问题只能凭现象猜测。错配:用其他版本 mapping 还原,类方法对应错误,分析走偏。预防:版本构建即归档、校验 mapping 与版本对应、定期抽查符号化演练。旧长期支持版本的 mapping 也要保留。
原理流程
mapping 缺失 → 栈不可读
mapping 错配 → 还原错误位置
代码或图示
校验:崩溃版本 ↔ 归档 mapping 版本一致
常见误区
- 清理构建产物时一并删除 mapping,未归档。
- 本地新构建 mapping 拿来还原线上旧版本栈。
追问
- 丢失 mapping 还能排查吗?答:可按包名/短名与行为粗分,无法精确到源码行。
- 如何做 mapping 可靠性演练?答:取历史样本栈走还原流程,确认可读。
07.1.1.11.3-020 资源混淆与代码 mapping 是什么关系?
一句话结论
代码混淆 mapping 记录符号映射;资源混淆(资源名/ID 压缩)有独立的资源映射表,二者分开管理;资源名变化不影响代码 mapping。
概念解释
R8 处理代码符号,资源压缩/混淆处理资源名与 ID。资源混淆工具生成资源名映射,用于还原资源引用。两套映射独立归档。多数项目资源 ID 在打包期固定,资源混淆按工具方案处理。混淆排查崩溃栈用代码 mapping,排查资源问题用资源映射。
原理流程
代码:R8 mapping
资源:资源名/ID 映射
各自归档,独立还原
代码或图示
区分:代码符号映射 vs 资源映射表
常见误区
- 把资源混淆映射当代码 mapping 用,还原栈失败。
- 资源重命名后动态按名查找资源未做适配。
追问
- 资源 ID 会被混淆改变吗?答:按资源压缩/混淆方案而定,引用方式需核对(待确认)。
- 动态资源名查找要注意什么?答:避免硬编码资源名,用 ID 引用或保留资源名。
07.1.1.11.3-021 安装包由哪些部分构成?
一句话结论
包体主要由代码 dex、原生库 so、资源文件、图片/媒体、字体、清单与签名信息构成;分析包体先拆解各部分占比,定位体积大头再优化。
概念解释
APK/AAB 内容:dex 字节码、lib 下各 ABI 的 so、res 资源、assets 原始文件、图片媒体、字体、Manifest 与签名。AAB 不直接安装,按设备生成 APK。包体优化按构成分项治理:代码收缩、so 裁剪、资源压缩、图片优化。先量化各部分占比,避免盲目优化小项。
原理流程
解包分析:dex / so / res / assets / 媒体
→ 占比排序 → 定位大头 → 分项优化
代码或图示
构成:code(dex) / native(so) / resources / media / assets
常见误区
- 只看总包体大小,不拆分项占比。
- AAB 与 APK 体积口径混淆,交付体积以商店按设备下发为准。
追问
- AAB 与 APK 体积为何不同?答:AAB 按设备配置拆分下发,单设备 APK 小于通用包。
- 哪部分通常占比最大?答:so、图片媒体与代码,随项目类型不同。
07.1.1.11.3-022 代码 dex 体积如何分析与压缩?
一句话结论
代码体积来自类/方法字节码,通过 R8 收缩未引用代码、混淆缩短符号、优化内联合并减小 dex;分析按类/包统计代码占比。
概念解释
dex 体积随引入类与方法增长。压缩手段:开启 R8 minify、移除无用依赖与类、混淆缩短符号、优化合并。分析工具按包/类统计 dex 占比,定位大模块与冗余库。多 dex 拆分后各 dex 分别统计。代码优化收益常小于 so 与媒体,但累积可观。
原理流程
依赖与代码 → R8 收缩/混淆/优化
→ dex 体积下降
代码或图示
分析:按包/类统计字节码占比 → 冗余裁剪
常见误区
- 未开 minify,全部代码与符号进入包体。
- 引入无用第三方依赖,代码体积被动增长。
追问
- 如何定位 dex 里的大模块?答:用构建分析工具按包统计代码量,结合依赖树排查。
- 多 dex 对体积有影响吗?答:dex 结构本身有开销,类数量决定总体积。
07.1.1.11.3-023 原生库 so 体积如何构成与裁剪?
一句话结论
so 按 ABI 打包,每个架构一份原生库;so 体积常是包体大头,裁剪方式包括只保留必要 ABI、移除未用原生库、剥离调试符号与压缩优化。
概念解释
同一原生库为各 CPU 架构分别编译,打包多 ABI 时体积成倍叠加。裁剪:保留目标用户架构、移除不用的 so、剥离符号(符号表单独归档)、使用压缩/优化构建。ABI 选择结合设备分布与上架 64 位要求。so 体积分析按架构与库分别统计。
原理流程
各 ABI so 打包
→ 裁剪 ABI / 移除无用库 / 剥离符号
→ so 体积下降
代码或图示
裁剪:abiFilters / 未用 so 移除 / 符号剥离
常见误区
- 保留全部 ABI,包体被多架构 so 放大。
- 剥离符号后未归档符号表,线上原生栈不可还原。
追问
- 64 位设备能跑 32 位 so 吗?答:按系统与设备兼容情况,上架要求见合规题目(待确认)。
- so 压缩能减小安装体积吗?答:压缩与加载策略相关,具体生效方式待确认。
07.1.1.11.3-024 资源文件体积如何分析?
一句话结论
资源体积包括 res 下布局、drawable、values 与 assets 原始文件;分析按资源类型与目录统计,找出大文件与冗余资源。
概念解释
资源分类:图片 drawable、布局 XML、字符串/样式、assets 原始文件。分析定位大体积资源文件、重复资源、未使用资源。assets 不参与资源引用检查,需人工排查冗余。资源随配置(屏密度、语言)打包多份,多配置叠加体积。资源优化与代码收缩配合。
原理流程
资源扫描:按类型/目录/大小
→ 大文件 / 冗余 / 未引用
→ 压缩移除
代码或图示
分类:drawable / layout / values / assets / 多配置
常见误区
- assets 里大文件未排查,资源压缩工具覆盖不到。
- 多语言/多密度资源全量打包,未按目标裁剪。
追问
- 未引用资源如何识别?答:shrinkResources 与资源分析工具结合,见后续题目。
- 资源体积与图片体积区别?答:图片是资源的一类,单独优化收益常最明显。
07.1.1.11.3-025 图片资源如何优化体积?
一句话结论
图片优化:选择合适格式与压缩率、按屏密度提供尺寸、移除大图与冗余切片、矢量图替代简单图形;图片常是资源体积大头。
概念解释
手段:压缩格式(WebP 等)、按密度切图避免超高分辨率、合并/删除重复图标、简单图形用矢量图、大图走网络下载不内置。分析定位超大图片与多密度重复。优化需兼顾画质,避免压缩过度影响显示。图片内存占用与磁盘体积是两个问题,见内存章节。
原理流程
图片盘点 → 格式压缩 / 尺寸适配 / 矢量替代
→ 大图外置网络
代码或图示
优化:format / density / vector / 外置 CDN
常见误区
- 内置超高分辨率原图,磁盘与解码内存双高。
- 只压缩格式不调整尺寸,体积下降有限。
追问
- WebP 兼容性如何?答:按 minSdk 与格式特性核对,透明/动图支持需确认(待确认)。
- 多密度图片如何取舍?答:按目标设备密度提供必要档位,其余由系统缩放。
07.1.1.11.3-026 字体、音频、视频等资源如何控制体积?
一句话结论
字体/音频/视频等二进制资源按需内置,大文件优先网络下载;字体子集化裁剪字符集,媒体压缩格式与码率优化,避免全量打包非首屏资源。
概念解释
字体:只内置必需字重与字符子集,特殊字体按需下载。音频/视频:引导页/背景音等短音频压缩,长视频不内置走网络。assets 中这类大文件需单独盘点。资源下载要考虑首次使用流量与缓存策略。非首屏资源延迟获取,降低初始包体。
原理流程
二进制资源盘点
→ 字体子集 / 媒体压缩
→ 非必需外置下载
代码或图示
策略:内置必需 + 按需下载,字体子集化
常见误区
- 内置完整字库或长视频,包体显著增大。
- 媒体未压缩,码率格式冗余。
追问
- 字体子集化有什么限制?答:裁剪字符需覆盖文案,动态文案字符可能缺失(待确认工具支持)。
- 外置资源如何保证首屏可用?答:首屏必需内置,其余延迟下载并带占位。
07.1.1.11.3-027 shrinkResources 如何压缩未引用资源?
一句话结论
shrinkResources 在代码收缩基础上移除未被引用的资源文件,需配合 minifyEnabled 开启;引用方式特殊(动态名、反射)的资源需用 keep 规则保留。
概念解释
资源压缩分析代码与 XML 中对资源 ID 的引用,未引用资源不打包。它依赖 R8 收缩结果,所以要先开 minify。动态按名引用、反射查找的资源可能被误删,需资源 keep 规则显式保留。开启后验证各页面资源正常。资源压缩只删未引用文件,不压缩文件内部体积。
原理流程
minify 收缩代码 → 资源引用分析
→ 未引用资源移除 → 引用保留
代码或图示
isMinifyEnabled = true
isShrinkResources = true
常见误区
- 单独开 shrinkResources 不开 minify,不生效。
- 动态资源被误删,release 页面对应图片/样式缺失。
追问
- 如何保留动态引用资源?答:资源 keep 规则声明保留指定资源,语法以 AGP 文档为准(待确认)。
- 资源压缩会删 assets 吗?答:assets 不走资源引用检查,通常不被自动移除。
07.1.1.11.3-028 如何判定资源是否被引用?
一句话结论
静态引用通过 ID 在代码/XML 中可被分析;动态按名/路径引用、反射、框架约定资源不被静态识别,需人工核对并显式保留。
概念解释
引用类型:R 类 ID 引用可追踪;字符串路径、资源名拼接、插件/动态框架加载不可静态识别。判定时先依赖工具报告未引用资源,再人工排除动态使用项。误删风险集中在动态资源。建立资源命名与引用规范,减少隐式引用。
原理流程
工具列出未引用候选
→ 人工核对动态/反射引用
→ 确认无用移除,动态保留
代码或图示
可追踪:R.id/R.drawable;不可追踪:名称拼接/反射/插件
常见误区
- 工具报未引用就直接删,动态资源被移除。
- 框架约定的资源未纳入人工核对。
追问
- 多模块资源如何引用分析?答:跨模块资源 ID 引用纳入整体分析,注意模块边界。
- 如何降低误删概率?答:release 包资源相关用例回归,页面图片样式走查。
07.1.1.11.3-029 资源混淆与压缩工具有哪些手段?
一句话结论
资源手段包括系统资源收缩、资源名/路径压缩、图片格式优化与第三方资源压缩工具;按项目工具链选择,注意保留动态引用与还原映射。
概念解释
系统能力:shrinkResources 移除未引用资源。额外工具:资源名混淆、图片压缩批量处理、冗余资源检测。部分第三方插件做资源短名与路径压缩。使用工具需生成映射表归档,避免动态资源找不到。工具链选择不引入额外构建链时优先系统能力。
原理流程
未引用移除 → 图片压缩 → 资源名/路径压缩(可选)
→ 映射归档
代码或图示
手段:系统收缩 / 图片压缩 / 资源混淆工具
常见误区
- 资源混淆后动态按名查找失效,未做适配。
- 压缩工具损失画质未评估。
追问
- 资源混淆有必要吗?答:包体敏感且动态资源可控时再评估,收益以实测为准。
- 资源映射表需要归档吗?答:需要,用于排查资源引用问题,具体格式按工具。
07.1.1.11.3-030 包体分析用什么方法与工具?
一句话结论
用 APK/AAB 分析器查看各组成占比、文件列表与明细,结合构建报告按模块/依赖统计;先拆大头再逐项优化,优化前后对比体积。
概念解释
分析入口:构建产物分析工具查看 dex/so/资源/媒体占比与单文件大小;依赖树排查冗余库;导出体积报告分模块对比。分析流程:解包分项 → 定位最大项 → 优化 → 复测对比。本地分析 release 产物,debug 包未收缩不代表交付体积。
原理流程
release 产物 → 分析器分项占比
→ 大文件/大模块定位
→ 优化复测对比
代码或图示
工具:APK 分析器 / 构建报告 / 依赖树
常见误区
- 分析 debug 包体积,未反映 R8 收缩后的真实交付体积。
- 只看总大小,不拆到文件与模块层级。
追问
- 如何对比版本间包体变化?答:记录各分项体积基线,新版本对比增量来源。
- 分析器显示的体积是下载还是安装大小?答:区分压缩下载体积与解压安装体积,口径需注明。
07.1.1.11.3-031 包体指标如何建立基线与监控?
一句话结论
按代码/so/资源/媒体分项记录体积基线,新版本对比增量与来源;包体指标纳入版本检查,防止依赖与资源无序增长。
概念解释
基线:各分项体积与总包体(下载/安装口径)。监控:每次发布对比上一版本增量,定位增长来自哪个模块/依赖/资源。包体门禁设阈值,超增量告警。分 ABI 与交付形态(AAB/APK)分别记录。基线随版本更新,避免标准长期偏低。
原理流程
release 产物分项体积 → 基线记录
→ 新版本对比增量来源
→ 超阈值告警/门禁
代码或图示
指标:code / so / res / media 体积,按版本与 ABI
常见误区
- 只记总包体,增长来源无法定位。
- 下载体积与安装体积口径混用。
追问
- 包体门禁阈值怎么定?答:按历史基线与商店/用户容忍度设定增量上限,具体数值按业务(待确认)。
- 如何监控依赖引入带来的体积增长?答:依赖树对比 + 分项体积变化。
07.1.1.11.3-032 包体优化收益如何量化对比?
一句话结论
同构建配置下对比优化前后各分项与总体积,区分代码收缩、so 裁剪、资源/图片优化各自贡献;验证体积下降且功能与画质未受损。
概念解释
量化:固定构建变体与 ABI,记录优化前后分项体积。逐项收益:R8 收缩减少代码、ABI 裁剪减少 so、图片压缩减少资源。避免把压缩率当安装体积收益。优化后回归功能与显示质量。收益按用户下载体积与安装体积分别评估。
原理流程
基线产物分项体积
→ 单项优化 → 复测对比
→ 汇总收益 + 质量回归
代码或图示
对比表:版本 / 分项 / 优化前 / 优化后 / 降幅
常见误区
- 优化前后构建配置不同,体积对比不可比。
- 只看总包体,不拆分各项贡献。
追问
- 哪种优化收益通常最大?答:so 裁剪与图片压缩常最显著,按项目构成实测。
- 体积下降会影响性能吗?答:收缩裁剪不影响运行功能;图片压缩需评估画质与解码内存。
07.1.1.11.3-033 重复资源与冗余依赖如何排查?
一句话结论
冗余包括重复图片/资源、未使用第三方库、重复功能实现;通过依赖树、资源扫描与代码引用分析定位,移除后复测功能。
概念解释
依赖冗余:引入但未使用的库、多库提供相同能力。资源冗余:重复图标、多版本图片、未引用文件。排查:依赖树查未用库,资源扫描查重复与未引用,代码查重复实现。移除前确认无隐式引用(反射、框架、跨模块)。第三方库裁剪结合其功能必要性。
原理流程
依赖树 + 资源扫描 + 代码引用
→ 标记冗余候选
→ 确认移除 → 复测
代码或图示
排查:未用依赖 / 重复资源 / 重复实现
常见误区
- 未使用库被保留,持续贡献代码体积。
- 移除资源/库未做跨模块回归,隐式引用断裂。
追问
- 如何判断依赖是否被使用?答:按引用与功能入口分析,注意注解处理器与运行期注入(待确认工具能力)。
- 重复功能实现如何取舍?答:保留统一实现,移除重复模块,注意兼容迁移。
07.1.1.11.3-034 动态特性按需交付如何减小初始包体?
一句话结论
动态特性模块(Dynamic Feature)按用户需要按需下载安装,不进入初始包;适合低频功能与大模块,降低首次下载体积,代价是按需下载与安装管理。
概念解释
动态特性从基础包拆分,用户进入对应功能时按需下载。收益:初始包体减小。代价:按需下载流程、安装状态管理、版本兼容与回退。适合低频、体积大的模块。是否使用动态交付结合商店支持与功能分布。具体机制与限制以 AAB 动态交付文档为准(待确认)。
原理流程
基础包 + 动态特性模块
→ 按需下载安装
→ 初始包体减小
代码或图示
拆分:基础模块 / 动态功能模块,按需交付
常见误区
- 高频核心功能拆成动态模块,首次使用等待下载体验差。
- 未处理下载失败与未安装状态,功能入口异常。
追问
- 动态模块与插件化有何区别?答:动态特性基于官方 AAB 交付机制,插件化是运行期加载方案,见相关章节。
- 动态模块对混淆/BP 有何影响?答:独立打包与编译,覆盖关系需单独评估,见性能章节。
07.1.1.11.3-035 什么是 ABI,支持哪些 CPU 架构?
一句话结论
ABI 对应 CPU 指令集架构,原生库按 ABI 编译为对应 so;常见架构包括 arm 与 x86 系列,设备按自身架构加载匹配 so。
概念解释
不同 CPU 架构有独立指令集,so 必须按 ABI 提供。设备安装时加载匹配架构的原生库;无匹配架构可能依赖兼容翻译或无法运行。项目按用户设备分布选择保留的 ABI。架构演进从 32 位向 64 位过渡。具体支持的架构枚举随 NDK 版本变化(待确认)。
原理流程
NDK 按 ABI 编译 so
→ 设备按架构加载匹配库
代码或图示
ABI:arm 32/64 位、x86 系列(以 NDK 文档为准)
常见误区
- 以为一份 so 通用所有架构;so 与 ABI 一一对应。
- 忽略设备架构分布,保留过多或过少 ABI。
追问
- 如何查看设备支持的 ABI?答:系统属性披露支持列表,具体 API 待确认。
- 一个 so 能包含多架构吗?答:通常按 ABI 分开打包,架构合并方式按工具链。
07.1.1.11.3-036 如何按 ABI 分包减小体积?
一句话结论
按 CPU 架构分别生成独立包,每个包只含对应 ABI 的 so;用户设备下载匹配包,避免包内打包全部架构。
概念解释
多 ABI 通用包把各架构 so 都打入,体积叠加。分包后每包只含目标架构 so,单包体积下降。分包方式可通过 AAB 按设备拆分或生成多 APK。需保证各分包功能一致、签名一致。ABI 选择结合设备分布,覆盖主流架构。
原理流程
按 ABI 拆分产物
→ 设备下载匹配包
→ 单包只含必要 so
代码或图示
abiFilters 限定架构;分包按 ABI 输出
常见误区
- 分包后某架构漏打包,对应设备无法运行原生功能。
- 各分包版本/签名不一致,升级异常。
追问
- AAB 是否还需要手动 ABI 分包?答:AAB 按设备配置自动拆分交付,具体行为待确认。
- 如何统计各 ABI 用户占比?答:崩溃/安装设备架构分布,决定保留哪些架构。
07.1.1.11.3-037 AAB 如何按设备配置交付?
一句话结论
AAB 上架后由商店根据设备 ABI、屏密度、语言等配置生成并下发对应 APK,应用无需为每种配置出独立包;减小单设备下载体积。
概念解释
AAB 包含所有配置的资源与 so,商店在安装时按设备匹配生成 split APK。应用提交 AAB,商店处理拆分。开发本地仍可生成通用 APK 测试。AAB 交付能力依赖商店支持。理解 AAB 与最终安装 APK 的关系有助于包体口径判断。
原理流程
上传 AAB
→ 商店按设备配置拆分
→ 下发匹配 split APK
代码或图示
AAB → split(ABI / density / language) → 设备安装
常见误区
- 用 AAB 总体积当作用户下载体积;实际按设备下发子集。
- 以为 AAB 必须手动拆多 APK 上传。
追问
- AAB 与多 APK 上架如何选?答:按商店要求与交付能力,AAB 为推荐方式(待确认商店政策)。
- 本地如何模拟设备拆分?答:构建工具可按配置生成对应 APK 验证。
07.1.1.11.3-038 上架对 64 位支持有什么要求?
一句话结论
主流商店要求应用提供 64 位原生库支持,仅 32 位 so 可能被限制上架;需同时提供 64 位架构 so 并验证 64 位设备运行。
概念解释
平台逐步要求 64 位支持:含原生库的应用需提供对应 64 位 ABI。纯 Java/Kotlin 无 so 的应用不受 so 架构限制。接入 NDK/三方原生库时确认其提供 64 位构建。上架前在 64 位设备验证原生功能。具体目标要求与截止政策以目标商店与系统版本为准(待确认)。
原理流程
含 so → 提供 64 位 ABI 构建
→ 64 位设备验证 → 满足上架要求
代码或图示
要求:64 位 so 提供 + 设备验证
常见误区
- 只带 32 位 so,上架审核被拒。
- 引入的三方原生库无 64 位版本,自身无法补齐。
追问
- 如何确认三方库有 64 位 so?答:检查库产物 ABI 目录与发布说明。
- 64 位 so 体积会增加吗?答:增加 64 位架构库,可通过 AAB 分包按设备交付抵消部分影响。
07.1.1.11.3-039 so 的压缩与加载需要注意什么?
一句话结论
so 加载方式与压缩配置影响安装体积与运行加载;需按系统对未压缩 so 的加载要求配置,避免运行期解压或加载失败。
概念解释
部分系统版本要求 so 以未压缩形式对齐存放以便内存映射加载。压缩配置错误可能导致加载失败或额外解压开销。构建配置按目标版本要求设置。so 体积优化与加载可用性需同时验证。具体压缩与对齐要求随系统版本变化(待确认)。
原理流程
so 打包配置(压缩/对齐)
→ 安装后按策略加载
→ 验证加载成功与体积
代码或图示
关注点:so 压缩状态 / 页对齐 / 内存映射加载
常见误区
- 一味压缩 so,违反系统加载要求导致崩溃。
- 未在目标版本验证 so 加载路径。
追问
- 未压缩 so 为何有利于加载?答:可直接内存映射,避免运行期解压,具体机制待确认。
- 如何检查 so 打包配置?答:查看构建产物 so 压缩状态与对齐信息。
07.1.1.11.3-040 保留多 ABI 的包体权衡如何做?
一句话结论
ABI 保留范围在覆盖用户与包体之间权衡:按设备架构分布保留主流架构,长尾架构通过分包/按需处理;64 位要求与兼容覆盖同时满足。
概念解释
保留 ABI 越多兼容越广,但 so 体积越大。决策依据:线上设备架构分布、商店 64 位要求、原生库提供能力。长尾低占比架构可放弃或分包。权衡结论记录在发布配置中。新增架构支持需验证对应原生库。
原理流程
设备 ABI 分布 + 64 位要求
→ 确定保留架构
→ 体积与覆盖权衡
代码或图示
权衡:覆盖用户占比 ↔ so 包体体积
常见误区
- 无脑全保留 ABI,包体无谓增大。
- 砍掉仍有一定占比的架构,兼容受损。
追问
- 架构分布数据从哪里来?答:崩溃安装设备与商店统计的 ABI 分布。
- 后续能否调整 ABI 范围?答:随设备分布演进更新配置,新版本验证兼容。
07.1.1.11.3-041 原生库本身如何裁剪体积?
一句话结论
so 裁剪包括移除未用原生库、剥离调试符号、编译优化与裁剪未用功能代码;符号表剥离后需归档以便原生栈还原。
概念解释
原生库体积来源:编译产物、调试符号、静态链接的依赖。裁剪:移除未加载的 so、剥离符号表(单独归档)、按 release 优化编译、裁剪原生侧未用代码。三方 so 不可改源码时通过选择精简版本与移除冗余架构。裁剪后验证原生功能与崩溃符号化。
原理流程
so 盘点 → 移除未用库 / 剥离符号 / 编译优化
→ 功能验证 + 符号归档
代码或图示
裁剪:未用 so / 符号剥离 / release 优化 / 静态依赖精简
常见误区
- 剥离符号后未归档,线上 Native 崩溃栈不可还原。
- 移除 so 未核对加载点,运行期找不到库。
追问
- 静态链接依赖为何增大 so?答:链接进产物的代码随 so 打包,未用部分应裁剪。
- 如何查看 so 内符号与大小?答:原生工具按库统计符号与大小,具体工具链待确认。
07.1.1.11.3-042 架构相关问题与包体优化如何区分处理?
一句话结论
架构相关崩溃/加载失败属于兼容正确性问题,ABI 裁剪属于包体优化;优化前先保证目标架构功能正确,再收缩保留范围,二者不能混为一谈。
概念解释
裁剪 ABI 降低体积的前提:被裁架构确无用户或已无价值。架构相关问题(so 加载失败、原生崩溃、兼容翻译异常)需在保留架构上修复。优化决策与正确性问题分开记录。上线前覆盖保留架构的设备验证。包体优化不以牺牲兼容正确性为代价。
原理流程
先验证各保留架构功能正确
→ 再裁剪无价值架构
→ 崩溃问题按架构单独跟踪
代码或图示
区分:兼容正确性问题 vs 包体体积优化
常见误区
- 为减小包体砍掉仍有用户的架构,引发兼容性崩溃。
- 把架构崩溃归因于优化,未定位 so 兼容问题本身。
追问
- 如何按架构统计崩溃?答:崩溃上报携带 ABI 信息,分架构聚类。
- 翻译兼容层导致的问题如何处理?答:优先提供原生 64 位 so,减少兼容翻译依赖。
07.1.1.11.3-043 应用签名的作用是什么?
一句话结论
签名标识应用作者身份、保证包完整性与升级一致性;系统通过签名校验安装包未被篡改,并要求升级包与原包签名一致。
概念解释
签名用途:身份认证(开发者身份)、完整性校验(包未被篡改)、升级一致性(更新包签名与已安装一致)、权限共享(同签名应用共享 UID/权限)。签名是安装与升级的前提。签名密钥对应应用身份,丢失影响后续升级。签名方案版本决定校验强度与兼容性。
原理流程
构建产物 → 签名方案签名
→ 安装/升级校验签名一致与完整
代码或图示
作用:身份 / 完整性 / 升级一致 / 共享权限
常见误区
- 以为签名只是商店要求;系统安装升级都依赖签名校验。
- 调试签名与发布签名混用,升级失败。
追问
- 同签名应用能共享什么?答:可配置共享 UID 与签名级权限,具体机制待确认。
- 签名会随包体分发吗?答:签名信息写入包内,证书用于校验。
07.1.1.11.3-044 v1 签名(JAR 签名)是如何工作的?
一句话结论
v1 基于 JAR 签名,对包内每个文件生成摘要并签名;校验粒度为文件级,不覆盖整包结构,防篡改能力较弱且兼容性最广。
概念解释
v1 为传统 JAR 签名方案:逐文件计算摘要、生成签名文件与证书。未被签名覆盖的部分(如 zip 结构、额外文件)可能被改动。v1 兼容低版本系统,但完整性保护弱于后续方案。高版本系统推荐叠加更强签名方案。v1 签名细节随签名方案版本演进(待确认)。
原理流程
逐文件摘要 → 签名与证书写入 META-INF
→ 安装时逐文件校验
代码或图示
v1:文件级摘要签名,覆盖 META-INF 内签名信息
常见误区
- 以为 v1 覆盖整个 APK 二进制;它只校验被签名文件内容。
- 高版本系统仍只依赖 v1,完整性保护不足。
追问
- v1 为何兼容性最广?答:早期系统仅支持 JAR 签名,低版本兼容依赖它。
- v1 与 v2 能否同时使用?答:可叠加签名,按目标系统选择方案组合。
07.1.1.11.3-045 v2 签名方案有什么改进?
一句话结论
v2 对整个 APK 二进制做签名,覆盖包结构与全部内容,校验更快、防篡改更强;签名块嵌入 APK,支持整包完整性校验。
概念解释
v2 在 APK 签名块中保存签名与证书,对整包内容做摘要签名。相比 v1 文件级校验,v2 覆盖整个二进制,任何结构改动都可被检出。校验时无需逐文件解压,速度更快。v2 要求 APK 结构满足签名块布局。高版本系统优先校验 v2。
原理流程
整包摘要 → 签名写入 APK 签名块
→ 安装时整包校验
代码或图示
v2:整包签名块,覆盖全部内容与结构
常见误区
- 以为 v2 只是 v1 的替代;两者校验粒度与覆盖范围不同。
- 后处理改动 APK 结构导致 v2 签名失效。
追问
- 哪些操作会破坏 v2 签名?答:重打包、修改包内文件后未重新签名。
- v2 与 v1 校验顺序?答:高版本优先 v2/v3,低版本回退 v1,具体待确认。
07.1.1.11.3-046 v3 签名与密钥轮换解决什么问题?
一句话结论
v3 支持密钥轮换:在签名中保留历史密钥与轮换链,允许应用在保留升级能力的前提下更换签名密钥;解决密钥泄露后无法平滑换钥的问题。
概念解释
传统升级要求签名一致,密钥泄露后无法换钥。v3 引入密钥轮换:新密钥签名并关联旧密钥链,系统认可轮换关系,可从旧签名升级到新签名。轮换有规则与限制,需按官方流程操作。v3 在 v2 整包签名基础上扩展密钥链信息。具体轮换规则以官方文档为准(待确认)。
原理流程
旧密钥 → 轮换链记录
→ 新密钥签名 + 关联旧密钥
→ 系统按链认可升级
代码或图示
v3:密钥轮换链,旧密钥可被新密钥替换升级
常见误区
- 以为换密钥后旧用户直接无法升级;v3 轮换可保留升级路径。
- 密钥轮换随意操作,破坏轮换链导致升级失败。
追问
- v3 轮换需要用户端系统版本支持吗?答:低版本系统对轮换支持有限,兼容方案待确认。
- 密钥轮换会影响商店上架吗?答:需按商店与平台流程处理,具体政策待确认。
07.1.1.11.3-047 v4 签名用于什么场景?
一句话结论
v4 是增量签名方案,为 APK 提供基于文件的签名元数据,支持增量安装与快速校验;通常与 v2/v3 配合使用,不是独立完整签名方案。
概念解释
v4 生成配套签名文件,服务于增量更新与安装校验场景,签名信息与 APK 对应。它不替代 v2/v3 的整包签名,而是补充增量能力。是否生成 v4 签名按构建配置与需求决定。具体文件格式与适用场景以官方文档为准(待确认)。
原理流程
v2/v3 整包签名
→ v4 生成增量签名元数据
→ 增量安装/快速校验使用
代码或图示
v4:配套签名文件,服务增量安装
常见误区
- 以为 v4 可单独作为完整签名方案。
- 增量更新时 v4 元数据与 APK 版本不匹配。
追问
- v4 签名文件何时生成?答:构建签名阶段按配置输出,具体产物名待确认。
- 哪些场景依赖 v4?答:增量安装与相关系统机制,按目标版本核对。
07.1.1.11.3-048 各签名方案如何选择与兼容?
一句话结论
按 minSdk 与目标设备选择签名方案组合:高版本用 v2/v3 整包签名,低版本兼容保留 v1;构建配置启用对应方案,兼容与强度兼顾。
概念解释
方案选择依据:最低支持版本、密钥轮换需求、商店要求。新版本系统校验 v2/v3,旧版本回退 v1。构建中可同时启用多方案,签名块按方案叠加。兼容矩阵随系统版本变化,发布前在低版本设备验证安装。具体默认启用方案随 AGP 版本(待确认)。
原理流程
minSdk / 兼容需求
→ 启用 v1/v2/v3(+v4)
→ 多版本设备安装验证
代码或图示
组合:v1 兼容旧版 + v2/v3 整包校验
常见误区
- 只开高版本方案,低版本设备安装失败。
- 只保留 v1,完整性保护不足。
追问
- 如何查看 APK 使用了哪些签名方案?答:签名校验工具读取签名块方案信息。
- 签名方案升级需要重新上架吗?答:方案变化属构建配置变更,新版本验证兼容后发布。
07.1.1.11.3-049 签名密钥库与密钥如何管理?
一句话结论
发布密钥存于受控密钥库,分离调试与发布密钥;密钥库密码、密钥口令分级保管,CI 中通过安全注入使用,不把密钥明文提交仓库。
概念解释
密钥管理要素:密钥库文件、库密码、密钥别名与口令。发布密钥严格受控,仅授权构建环境访问。CI 通过密钥注入/凭据管理使用,不入库明文。定期备份密钥库。调试密钥与发布密钥分离,避免混用。密钥访问审计与轮换流程制度化。
原理流程
密钥库受控保存
→ CI 安全注入签名
→ 不提交明文 / 定期备份
代码或图示
管理:keystore / storePassword / keyAlias / keyPassword
常见误区
- 密钥库与口令提交到代码仓库,泄露风险。
- 调试密钥直接用于发布包。
追问
- 密钥库备份为什么重要?答:丢失发布密钥将无法对原应用升级,见后续题目。
- CI 中密钥如何安全使用?答:凭据从安全存储注入,构建环境临时使用,不落明文。
07.1.1.11.3-050 签名密钥丢失或泄露有什么后果?
一句话结论
发布密钥丢失将无法为原应用签名升级,通常只能换包重发;密钥泄露则身份可被冒用,需按轮换/应急流程处理,风险极高。
概念解释
丢失:升级包必须与已安装包签名一致,无密钥则无法发布更新,老用户无法收到升级。泄露:他人可用同一密钥签名仿冒包,破坏身份信任。预防:受控保管、备份、访问审计;泄露后评估密钥轮换(v3)或换包。应急流程需预先制定。
原理流程
密钥丢失 → 无法签名升级 → 换包重发
密钥泄露 → 身份被冒用 → 轮换/应急处置
代码或图示
风险:升级中断 / 身份仿冒;预防:保管 + 备份 + 审计
常见误区
- 以为密钥丢了可重新生成继续升级;签名不一致升级被拒。
- 泄露后未及时处置,仿冒包扩散。
追问
- v3 轮换能否解决密钥泄露?答:在支持轮换前提下可换钥升级,需按流程执行(待确认)。
- 换包重发对用户有何影响?答:需重新安装,数据迁移与老版本衔接需单独处理。
07.1.1.11.3-051 调试签名与发布签名有何区别?
一句话结论
调试签名由开发工具自动生成、仅用于本地与调试构建;发布签名使用受控密钥库,用于上架与升级;二者证书不同,不能混用升级。
概念解释
调试密钥在开发环境自动生成,过期可重建,不代表正式身份。发布密钥受控保管,对应线上应用身份。debug 包用调试签名,release 包用发布签名。用调试签名上架不可行;把调试签名当发布签名会带来身份与管理风险。不同构建变体配置各自签名。
原理流程
debug 变体 → 调试密钥自动签名
release 变体 → 发布密钥库签名
代码或图示
区分:debug keystore(自动) / release keystore(受控)
常见误区
- 发布包误用调试签名,升级与身份管理出问题。
- 调试密钥长期固定不轮换,与发布密钥混淆。
追问
- 调试签名过期怎么办?答:调试密钥可重新生成,仅影响调试安装,不影响发布包。
- 同应用 debug 与 release 能互相覆盖安装吗?答:签名不同,通常需卸载后安装。
07.1.1.11.3-052 升级时签名一致性如何校验?
一句话结论
系统安装更新时校验新包签名证书与已安装应用一致;签名不一致会拒绝升级,需卸载旧版后安装或通过密钥轮换路径升级。
概念解释
升级一致性:包名相同且签名证书匹配才允许覆盖安装。证书不同(换密钥、换签名方案证书)升级被拒。签名方案版本变化但证书不变通常不影响一致性。校验在安装阶段进行。理解这一点可解释「更新安装失败」中的签名不一致原因。
原理流程
已安装包签名 ↔ 新包签名
→ 一致允许升级 / 不一致拒绝
代码或图示
校验:packageName 相同 + 签名证书一致
常见误区
- 换了签名密钥仍期望直接覆盖升级,被系统拒绝。
- 包名相同但签名不同,误以为可升级。
追问
- 证书指纹相同是否就签名一致?答:以证书链比对为准,指纹是比对依据之一(待确认工具判定)。
- 签名方案从 v1 升到 v2/v3 影响升级吗?答:证书不变通常可升级,方案版本变化需实测。
07.1.1.11.3-053 多渠道包使用什么签名?
一句话结论
各渠道包应使用同一发布签名;渠道差异只体现在渠道标识/配置,不改变签名证书,保证所有渠道版本签名一致可升级。
概念解释
多渠道包面向不同分发渠道,渠道信息注入包内,签名仍用统一发布密钥。若各渠道签名不同,跨渠道升级被拒、身份不一致。渠道打包流程在签名前或后处理需保证最终包签名有效。渠道包与主包签名一致性纳入发布校验。
原理流程
注入渠道标识 → 统一发布签名
→ 各渠道包证书一致
代码或图示
渠道:标识差异;签名:同一发布证书
常见误区
- 不同渠道用不同密钥签名,跨渠道升级失败。
- 渠道后处理改动包体导致签名失效。
追问
- 渠道信息注入在签名前还是签名后?答:需保证注入后重新签名或注入不破坏签名,具体流程待确认。
- 渠道包签名如何校验一致?答:批量提取各包证书指纹比对。
07.1.1.11.3-054 签名校验如何用于防篡改?
一句话结论
安装与运行期可校验包签名证书,发现被重打包/篡改的包拒绝运行;签名是完整性与身份防线,但不能替代运行期安全防护。
概念解释
防篡改思路:安装期系统校验签名完整性;应用可在关键流程读取自身签名证书,与预期指纹比对,识别重打包。重打包修改代码后签名失效。签名校验不能防止调试 Hook、运行期注入等其他攻击,安全防护需多层。敏感校验逻辑本身也可能被绕过。
原理流程
重打包改代码 → 签名不匹配
→ 安装期拒绝 / 运行期指纹比对识别
代码或图示
校验:读取签名证书 → 比对预期指纹
常见误区
- 以为签名校验能阻止所有逆向与破解。
- 硬编码指纹后更换签名未同步更新校验值。
追问
- 运行期获取签名信息的方式?答:系统包管理器提供签名信息接口,具体 API 版本差异待确认。
- 签名校验被绕过怎么办?答:结合混淆、完整性校验与服务端校验多层防护。
07.1.1.11.3-055 签名方案在构建中如何配置?
一句话结论
在构建配置中声明签名配置(密钥库、别名、口令)与启用的签名方案,绑定到 release 变体;凭据通过安全方式注入,不硬编码明文。
概念解释
配置要素:签名配置引用密钥库与凭据,构建变体指定使用该配置;签名方案开关按目标版本启用。口令可从环境变量/凭据文件读取,避免明文写入脚本。CI 与本地配置分离。构建产物签名信息可在出包后校验。具体 DSL 属性以 AGP 版本为准(待确认)。
原理流程
签名配置(keystore/alias/凭据)
→ 绑定 release 变体
→ 出包签名 + 校验
代码或图示
android {
signingConfigs {
create("release") {
storeFile = file("release.keystore")
// 口令从安全配置读取,不写明文
}
}
}
常见误区
- 口令明文写进构建脚本并入库。
- release 变体未绑定发布签名配置,产物用默认调试签名。
追问
- 签名方案开关在哪里配置?答:AGP 签名配置中按方案启用,具体项名以文档为准。
- 本地与 CI 签名配置如何统一?答:凭据分环境注入,配置模板一致。
07.1.1.11.3-056 证书指纹与包名如何绑定身份?
一句话结论
应用身份由包名与签名证书共同确定;同包名不同证书视为不同身份,服务端/SDK 常以包名加证书指纹做绑定校验。
概念解释
身份判定:包名标识应用,证书标识作者。服务端开放平台、SDK 接入常登记包名与签名指纹,校验调用方身份。证书指纹是证书的摘要值,用于比对。更换密钥后指纹变化,需同步更新登记。理解绑定关系可解释接入第三方平台时的签名校验失败。
原理流程
包名 + 证书指纹 → 登记平台
→ 运行期调用校验匹配
代码或图示
身份:packageName ↔ signing certificate fingerprint
常见误区
- 只核对包名,忽略证书指纹不一致。
- 换签名后未更新平台登记指纹,校验被拒。
追问
- 指纹如何获取?答:从发布密钥库导出证书摘要,工具生成指纹。
- 多渠道指纹应一致吗?答:同一发布签名下各渠道指纹一致。
07.1.1.11.3-057 渠道包需求有哪些生成方式?
一句话结论
渠道包用于区分分发来源与统计;生成方式包括构建变体/flavor 注入、打包期渠道标识写入、后处理快速重打包;按渠道数量与出包效率选择方案。
概念解释
需求:按渠道区分下载、激活、转化与崩溃归因。方式:Gradle flavor 按渠道出包;打包脚本批量注入渠道信息;快速打包方案在基础包上追加渠道信息后重签。渠道数量多时关注出包耗时与一致性。渠道方案不改变功能代码,只注入标识与配置。
原理流程
基础产物
→ 注入渠道标识
→ 重签(如需) → 渠道包归档
代码或图示
方式:flavor 注入 / 批量打包 / 后处理重签
常见误区
- 渠道包功能代码不一致,只应差异在标识配置。
- 后处理重打包后未重新签名,包无效。
追问
- flavor 与后处理打包怎么选?答:渠道少用 flavor 简单直接;渠道多追求速度用批量后处理(待确认方案细节)。
- 渠道包会影响 R8 优化吗?答:标识注入不改变代码可达性,具体注入时机待确认。
07.1.1.11.3-058 渠道信息如何注入到包中?
一句话结论
渠道标识写入包内可读位置(清单元数据、资源或配置文件),运行期读取上报;注入方式需保证可被统计 SDK 读取且不破坏签名。
概念解释
注入位置:Manifest meta-data、字符串资源、assets 配置文件等。运行期统计 SDK 读取渠道值上报。注入发生在打包流程中,写入后按签名要求处理。渠道值命名规范统一,便于归因聚合。动态下发渠道配置另走运行期接口。
原理流程
打包期写入渠道标识
→ 运行期读取
→ 上报统计归因
代码或图示
注入:meta-data / res / assets;读取:运行期渠道值
常见误区
- 注入渠道后未重新签名,签名校验失败。
- 渠道值格式不统一,统计聚合错乱。
追问
- 渠道标识放哪里最常见?答:Manifest 元数据是常见方式,具体按统计 SDK 约定。
- 运行期能否覆盖渠道?答:可结合安装渠道与运行配置,归因口径需明确。
07.1.1.11.3-059 多渠道与包体、签名是什么关系?
一句话结论
多渠道不改变代码与 so 主体,渠道差异通常只在标识配置;所有渠道包共用同一发布签名与主体产物,包体基本一致,签名证书一致。
概念解释
渠道包基于同一基础产物生成,代码/so/资源主体相同,包体差异极小(仅标识配置)。签名使用统一发布密钥。若为每个渠道单独全量构建,出包慢且易产生差异。批量打包应保持主体一致。渠道包体与签名一致性纳入发布校验。
原理流程
同一基础产物 → 各渠道注入标识
→ 统一签名 → 包体/证书一致
代码或图示
一致:代码 / so / 资源 / 签名;差异:渠道标识
常见误区
- 渠道包分别全量构建,产物出现非预期差异。
- 渠道包签名或包体与主包不一致未被发现。
追问
- 渠道包体积为何应基本一致?答:主体代码资源相同,仅配置标识差异。
- 如何批量校验渠道包一致性?答:比对证书指纹、主体 hash 与渠道标识。
07.1.1.11.3-060 渠道统计标识如何设计与归因?
一句话结论
渠道标识按平台/来源/活动维度规范命名,安装后上报启动与激活数据,结合服务端归因;标识需稳定可追溯,避免重复与冲突。
概念解释
标识设计:渠道编码规则统一(来源、平台、活动位),区分应用商店、推广渠道、活动包。上报:首次安装、启动、激活事件携带渠道值。归因:服务端按渠道聚合转化。渠道冲突与覆盖规则明确(安装渠道优先于后续渠道)。离线渠道与在线推广区分。
原理流程
渠道编码规则 → 包内标识
→ 安装/激活上报 → 服务端归因聚合
代码或图示
归因:渠道编码 + 安装事件 + 转化链路
常见误区
- 渠道编码随意命名,聚合时无法区分来源。
- 多渠道覆盖规则不清,归因数据错乱。
追问
- 渠道与推广活动参数如何区分?答:渠道标识与营销参数分层记录,归因链路打通。
- 如何校验渠道上报正确?答:各渠道包启动上报对应编码,抽样核对。
07.1.1.11.3-061 快速多渠道打包有哪些手段?
一句话结论
渠道数量多时,在基础包上批量追加渠道标识并快速重签,避免为每个渠道全量编译;手段包括复用基础产物、增量注入与并行出包,权衡出包速度与包体一致性。
概念解释
全量编译每个渠道:慢,且各包可能有差异。快速打包:先构建一份基础包,批量注入渠道信息后处理生成各渠道包。注入与重签流程脚本化并行。速度提升来自复用编译产物。快速方案需验证最终包签名有效、渠道可读。具体工具与流程按项目技术栈(待确认)。
原理流程
基础包一次编译
→ 批量注入渠道 + 重签
→ 并行产出渠道包
代码或图示
提速:复用基础产物 / 增量注入 / 并行打包
常见误区
- 快速打包后未校验签名与渠道值,产物不可用。
- 注入方式破坏包结构,安装失败。
追问
- 快速打包与 flavor 全量构建差异?答:前者复用产物快,后者隔离彻底,按渠道规模选择。
- 重签耗时如何控制?答:签名步骤并行化,密钥读取走安全缓存(待确认实现)。
07.1.1.11.3-062 渠道包一致性如何校验?
一句话结论
批量出包后校验各渠道包签名证书一致、主体代码/资源一致、渠道标识正确且可安装;不一致的包拦截,不进入分发。
概念解释
校验项:证书指纹一致、主体文件 hash 一致、渠道编码正确、包可安装解析。批量产物自动比对,异常包剔除。渠道包与主包基线对比,防止混入非预期差异。校验结果记录归档。渠道数量大时校验自动化,避免人工逐包检查。
原理流程
批量产物 → 证书/主体/渠道/可安装校验
→ 异常剔除 → 合格包归档分发
代码或图示
校验:签名一致 / 主体一致 / 渠道正确 / 可安装
常见误区
- 只抽查个别渠道包,其余异常未发现。
- 渠道标识正确但主体被改动,未做 hash 比对。
追问
- 主体 hash 如何比对?答:提取包内代码资源摘要与基础包基线比对。
- 校验失败如何定位?答:对比异常包与基线包差异项,定位注入/重签环节。
07.1.1.11.3-063 CI 构建流水线由哪些环节组成?
一句话结论
CI 流水线通常包括代码拉取、依赖解析、编译构建、自动化测试、产物校验、归档与发布;各环节门禁串联,失败即阻断后续流程。
概念解释
环节:触发(提交/定时/手动)→ 拉取代码 → 环境准备 → 依赖解析 → 构建变体 → 测试(单元/静态检查/打包校验)→ 产物与 mapping 归档 → 发布。门禁:测试不通过、校验异常则阻断。流水线可复现、日志可追溯。CI 配置纳入版本管理。
原理流程
触发 → 拉取 → 构建 → 测试 → 校验 → 归档 → 发布
代码或图示
流水线:checkout / build / test / verify / archive / release
常见误区
- CI 只出包不跑测试,问题带到线上。
- 环境依赖手工配置,流水线不可复现。
追问
- 流水线触发方式有哪些?答:提交触发、定时构建、手动发布,按阶段配置。
- 产物归档包含什么?答:APK/AAB、mapping、构建信息与版本记录。
07.1.1.11.3-064 构建缓存如何加速?
一句话结论
构建缓存包括 Gradle 任务缓存与依赖缓存,复用未变化任务的产物与已下载依赖,减少重复编译与下载;缓存命中按输入输出哈希判定。
概念解释
Gradle 缓存:任务输入未变则复用上次产物;依赖缓存复用已下载库。本地缓存与远程缓存结合,团队共享远程缓存。缓存失效条件:输入(源码、配置、依赖)变化。合理划分任务输入输出以提高命中率。缓存不改变产物正确性,只加速重复构建。
原理流程
任务输入哈希 → 命中缓存复用产物
→ 未命中重新执行
代码或图示
缓存:task cache / dependency cache / remote cache
常见误区
- 任务输入输出声明不全,缓存命中错误或失效。
- 缓存被污染未清理,产物异常。
追问
- 远程缓存如何共享?答:CI 与本地上传/拉取缓存,按团队配置(待确认 Gradle 版本能力)。
- 缓存导致产物不一致怎么办?答:清理缓存重建,核对任务输入声明。
07.1.1.11.3-065 并行构建与任务优化怎么做?
一句话结论
通过模块并行编译、任务依赖合理划分、避免串行等待与重复工作缩短构建时间;先测量耗时分布,再优化瓶颈任务。
概念解释
并行:独立模块并行编译,执行器分配并行度。任务优化:移除重复任务、合并可合并步骤、延迟非必要任务。先分析构建报告找耗时最长任务,再针对性优化。并行受模块依赖关系与资源限制。优化后复测构建耗时。
原理流程
构建耗时分析 → 瓶颈任务定位
→ 并行化 / 去重 / 精简
→ 复测耗时
代码或图示
优化:模块并行 / 任务依赖梳理 / 重复任务移除
常见误区
- 未测量就盲目调并行度,资源竞争反而变慢。
- 任务间隐式依赖未梳理,并行出问题。
追问
- 如何查看各任务耗时?答:构建报告输出任务耗时分布,定位瓶颈。
- 模块拆分对并行有何帮助?答:低依赖模块可独立并行编译。
07.1.1.11.3-066 构建变体与 flavors 如何组织?
一句话结论
构建变体由 buildType(debug/release)与 flavor(渠道/环境/产品维度)组合生成;变体隔离配置与依赖,按需构建目标产物。
概念解释
buildType 区分调试与发布优化配置;flavor 区分渠道、环境、产品形态。变体组合决定最终构建配置。公共配置抽取到基类,变体差异覆盖。变体过多会增加构建矩阵与出包成本。命名与维度规范统一。
原理流程
buildType × flavor → 变体
→ 各自配置/依赖 → 目标产物
代码或图示
维度:buildType(debug/release) + flavor(channel/env/product)
常见误区
- 变体维度混乱,配置覆盖关系不清。
- 变体过多导致 CI 构建矩阵膨胀。
追问
- 不同环境配置如何隔离?答:flavor 区分环境,配置与接口地址按变体注入。
- 变体依赖冲突如何处理?答:统一依赖版本,按变体排除冲突项。
07.1.1.11.3-067 产物归档与 mapping 上传流程是什么?
一句话结论
发布构建成功后归档 APK/AAB、mapping 与构建元数据(版本、变体、渠道、时间),mapping 上传符号化服务,与版本一一对应供线上还原。
概念解释
归档内容:产物包、mapping.txt、资源映射、构建信息(版本号、变体、渠道、commit、时间)。mapping 上传崩溃符号化平台,按版本归档。产物存入制品库供发布。归档与版本绑定,不可覆盖。CI 自动完成归档上传,失败则阻断发布。
原理流程
构建成功 → 产物 + mapping + 元数据
→ 归档制品库 / 上传符号化
代码或图示
归档:package / mapping / build metadata
常见误区
- 只归档包体,mapping 未上传,线上栈不可还原。
- 归档未记录版本/commit,事后无法对应。
追问
- mapping 上传失败要阻断发布吗?答:建议阻断,避免线上崩溃无法解析。
- 构建元数据记录哪些?答:版本号、变体、渠道、commit、构建时间与机器信息。
07.1.1.11.3-068 自动化测试如何接入 CI?
一句话结论
CI 在构建后自动运行单元测试、静态检查与必要的打包/设备校验,失败阻断发布;测试分层执行,快速检查前置,慢速测试按需触发。
概念解释
测试接入:单元测试随提交快速执行;静态检查(lint、规范)门禁;打包校验(产物可解析、签名、资源);必要的设备/集成测试在 CI 或专门环境运行。失败任务阻断流水线并反馈原因。测试结果与构建记录归档。测试覆盖与执行速度平衡。
原理流程
构建 → 单元测试 / 静态检查 / 打包校验
→ 通过归档 / 失败阻断
代码或图示
分层:unit test / lint / package verify / device test
常见误区
- CI 不跑测试,问题到上架前才暴露。
- 慢速测试全量阻塞每次提交,反馈周期过长。
追问
- 哪些测试必须进发布门禁?答:核心单元测试、静态检查与产物校验,集成测试按策略安排。
- 测试环境与本地不一致怎么办?答:CI 环境配置固化,依赖版本锁定。
07.1.1.11.3-069 签名凭据在 CI 中如何安全配置?
一句话结论
CI 不存明文密钥库与口令,凭据从安全凭据存储按流水线注入,构建结束不落盘明文;凭据访问受控并审计,与本地开发配置分离。
概念解释
安全实践:密钥库文件存于凭据管理或加密存储,口令用密钥/环境变量注入;构建环境临时使用,不写入日志与仓库。CI 凭据权限最小化。密钥库备份与恢复流程明确。本地调试使用调试密钥,不依赖发布凭据。具体注入方式按 CI 平台(待确认)。
原理流程
凭据安全存储
→ CI 流水线注入签名配置
→ 构建使用 / 不落明文 / 审计
代码或图示
注入:keystore 凭据 + 口令,来源安全存储
常见误区
- 密钥库与口令提交到 CI 配置或仓库。
- 构建日志打印签名口令。
追问
- 密钥库文件如何进 CI?答:加密存储或安全制品注入,构建时解密使用(待确认平台方式)。
- 凭据泄露如何处置?答:按密钥应急流程轮换,见后续题目。
07.1.1.11.3-070 如何系统性优化构建耗时?
一句话结论
先测量各阶段与任务耗时,再从缓存、并行、模块依赖、移除冗余任务与升级工具链入手优化;优化后持续监控构建时间基线。
概念解释
优化路径:缓存命中率提升、并行执行合理、模块依赖解耦、移除不必要任务与测试、升级 Gradle/AGP 工具链、按需触发构建。测量先行,避免盲目调整。构建时间纳入 CI 指标监控,随版本跟踪。优化不牺牲产物质量与测试覆盖。
原理流程
耗时测量 → 瓶颈分析
→ 缓存/并行/依赖/工具链优化
→ 复测 + 基线监控
代码或图示
手段:cache hit / parallel / dependency / task cleanup / toolchain
常见误区
- 跳过测量直接调参,优化方向错误。
- 为提速砍掉必要检查与测试。
追问
- 构建耗时基线如何记录?答:CI 记录各阶段时长,版本间对比趋势。
- 工具链升级有何收益与风险?答:可能提速,但需回归兼容,按版本评估(待确认)。
07.1.1.11.3-071 依赖版本如何统一管理?
一句话结论
依赖版本集中声明、统一升级与锁版本,避免各模块版本漂移与冲突;依赖变更评审并记录引入原因,防止冗余与体积膨胀。
概念解释
管理方式:版本目录或统一配置集中声明依赖版本;模块引用统一坐标。锁定版本避免解析到意外新版本。依赖树分析冲突与重复库。新增依赖评审必要性与体积影响。依赖升级回归测试。版本变更记录可追溯。
原理流程
版本集中声明 → 依赖解析
→ 冲突排查 → 评审引入 → 回归升级
代码或图示
管理:version catalog / lock / conflict resolution
常见误区
- 各模块手写版本号,同一库多版本冲突。
- 随手加依赖不评审,体积与兼容性风险累积。
追问
- 依赖冲突如何排查?答:依赖树查看版本选择与重复库,排除冲突项。
- 依赖升级何时安排?答:随版本迭代评估,重大升级单独回归。
07.1.1.11.3-072 构建产物发布前校验什么?
一句话结论
出包后校验产物可解析、签名有效、版本信息正确、资源与功能可用、体积在基线内;校验不通过不进入发布流程。
概念解释
校验项:包可安装解析、签名方案与证书正确、版本号/名称与渠道正确、核心资源完整、关键启动路径可用、体积与 so 架构符合预期。校验自动化在 CI 完成,结果记录。抽样人工走查补充。校验清单随发布流程固化。
原理流程
产物生成 → 解析/签名/版本/资源/体积校验
→ 通过归档 / 异常拦截
代码或图示
校验:parse / signature / version / resource / size / abi
常见误区
- 只确认包生成,未校验签名与可安装性。
- 版本号/渠道写错未在出包前发现。
追问
- 如何自动校验包可解析?答:打包校验工具解析清单与签名,具体工具链待确认。
- 体积校验阈值如何设定?答:对比体积基线,超增量告警。
07.1.1.11.3-073 从构建到上架的发布流水线如何组织?
一句话结论
发布流水线串联构建、测试、校验、归档、人工确认与上架;区分日常构建与正式发布,正式发布需版本确认、审核与灰度。
概念解释
流程:发布分支 → 版本号确定 → 构建 release 包 → 测试校验 → 归档产物与 mapping → 审批确认 → 上传商店 → 灰度/全量。日常 CI 构建与正式发布隔离。发布记录关联版本与产物。回滚与应急流程备用。流水线阶段权限分级。
原理流程
release 分支 → 构建 → 测试校验 → 归档
→ 审批 → 上架 → 灰度全量
代码或图示
阶段:build / test / verify / archive / approve / release
常见误区
- 日常构建包与正式发布包混在一起,版本管理混乱。
- 发布前缺少人工审批与版本确认环节。
追问
- 发布分支策略如何配合?答:按分支类型触发不同流水线,正式发布走 release 流程。
- 产物与版本记录如何对应?答:归档记录 commit、版本号与渠道,发布可追溯。
07.1.1.11.3-074 CI 失败门禁如何设置?
一句话结论
关键环节(编译、测试、静态检查、产物校验、mapping 归档)设为门禁,失败即阻断后续发布;非关键告警分级处理,不阻塞交付。
概念解释
门禁分级:必须通过项(编译成功、核心测试、签名校验、mapping 归档)阻断发布;提示项(建议优化、轻度告警)记录不阻断。门禁规则随质量要求演进。失败信息清晰反馈定位环节。门禁避免带病产物进入发布。
原理流程
各环节结果 → 门禁判定
→ 关键失败阻断 / 告警记录放行
代码或图示
门禁:compile / test / lint / verify / archive = required
常见误区
- 门禁过松,失败仍出包;过严,日常交付被无关告警阻塞。
- 失败原因不可读,排查成本高。
追问
- 测试不稳定(flaky)如何处理?答:隔离重试并修复用例,不直接降低门禁标准。
- 哪些项建议作为强制门禁?答:编译、核心测试、签名与产物校验、mapping 归档。
07.1.1.11.3-075 上架对目标 API 级别有什么要求?
一句话结论
主流商店按年份要求新提交与更新应用达到指定 targetSdk(目标 API 级别);未达标可能被拒绝上架或限制更新,需跟踪政策并及时升级适配。
概念解释
targetSdk 决定应用运行在高版本系统时启用的行为变更。商店定期提高最低目标 API 要求。升级 targetSdk 需适配对应版本行为变化(权限、后台、隐私等)。minSdk 与 targetSdk 分别配置。具体要求数值随商店与时间变化(待确认,以最新官方政策为准)。
原理流程
跟踪商店目标 API 要求
→ 升级 targetSdk + 行为适配
→ 回归测试 → 上架
代码或图示
配置:minSdk / targetSdk / compileSdk
常见误区
- 长期不升级 targetSdk,新版本上架被拒。
- 升级 targetSdk 未做行为适配,高版本设备功能异常。
追问
- targetSdk 升级要适配哪些变更?答:对应版本行为变更清单逐项核对,见系统章节。
- 如何确认当前要求?答:查目标商店开发者政策与官方目标 API 级别说明(待确认数值)。
07.1.1.11.3-076 64 位上架要求如何落地验证?
一句话结论
上架前确认包含 64 位 ABI 的原生库,在 64 位设备验证核心原生功能;纯 Kotlin/Java 无 so 应用按商店规则确认豁免情况。
概念解释
落地步骤:检查 lib 目录含目标 64 位架构 so;三方原生库提供 64 位版本;64 位真机/模拟器跑核心功能;核对商店 64 位政策。缺少 64 位 so 可能被拒。验证覆盖原生初始化与关键功能。具体豁免与政策以商店为准(待确认)。
原理流程
检查 64 位 so → 三方库确认
→ 64 位设备验证 → 满足上架
代码或图示
验证:ABI 清单 + 64 位设备核心路径
常见误区
- 只在 32 位设备测试,64 位兼容性未覆盖。
- 三方库无 64 位版本,自身 so 无法补齐。
追问
- 如何查看产物包含哪些 ABI?答:解包 lib 目录核对架构子目录。
- 纯 Java 应用也要满足 64 位要求吗?答:无原生库时按政策核对,待确认。
07.1.1.11.3-077 权限声明如何最小化与合规?
一句话结论
只声明功能必需的权限,按最小必要原则;运行时权限按需申请,移除未使用权限,权限用途在隐私说明中对应解释。
概念解释
权限治理:盘点 Manifest 声明与实际使用;删除未用权限;危险权限运行期申请并说明用途;权限分组与申请时机优化。上架审核关注多余敏感权限。权限与功能对应记录在隐私材料。Manifest 合并后核对最终权限清单。
原理流程
权限盘点 → 移除未用 / 最小必要
→ 运行期按需申请 → 隐私说明对应
代码或图示
治理:manifest 权限核对 + 运行时申请 + 用途说明
常见误区
- 保留历史遗留未用敏感权限,审核被质疑。
- 一次性申请多个权限,体验与合规风险。
追问
- 合并三方库带来的权限如何处理?答:核对三方权限必要性,可按规则移除未用项(待确认配置方式)。
- 权限声明与隐私政策不一致有何风险?答:审核驳回或合规问题。
07.1.1.11.3-078 隐私政策与数据收集合规需要注意什么?
一句话结论
收集的用户数据需有隐私政策说明,遵循最小收集与告知同意;数据类型、用途、第三方共享在政策与应用内明确,合规材料随版本维护。
概念解释
合规要点:数据收集范围与类型、用途说明、第三方 SDK 数据共享、用户查询/删除渠道、同意时机。上架需提供隐私政策。代码中数据收集与政策描述一致。三方 SDK 数据行为纳入合规盘点。政策随功能变更更新。具体法规与商店要求以适用地区为准(待确认)。
原理流程
数据收集盘点 → 政策与告知
→ 三方共享披露 → 版本同步维护
代码或图示
要素:数据类型 / 用途 / 共享 / 同意 / 权利渠道
常见误区
- 代码收集的数据与隐私政策描述不一致。
- 三方 SDK 收集行为未披露。
追问
- 如何盘点三方 SDK 数据行为?答:梳理接入 SDK 清单与其隐私条款,核对收集类型。
- 政策更新与版本发布如何同步?答:数据行为变更时同步更新隐私材料再上架。
07.1.1.11.3-079 数据安全表单与隐私清单如何准备?
一句话结论
商店数据安全表单按应用实际收集的数据类型、用途、是否共享与敏感程度如实填写;部分场景需配套隐私清单文件,与代码行为一致。
概念解释
数据安全表单:申报收集的数据类别、用途、是否传输与共享、加密与删除方式。隐私清单文件:按平台要求声明三方 SDK 与数据收集行为(具体格式随平台演进,待确认)。填写必须与实际代码一致,误报导致审核或合规问题。表单随版本数据行为变化更新。
原理流程
数据行为盘点
→ 填写安全表单 / 准备隐私清单
→ 与代码核对一致 → 提交
代码或图示
申报:data type / purpose / sharing / encryption / deletion
常见误区
- 表单填写与实际收集不符,被审核驳回。
- 新增 SDK 后未更新安全表单。
追问
- 隐私清单与数据安全表单是一回事吗?答:申报表单与清单文件形式不同,按商店要求分别准备(待确认)。
- 如何保证申报准确?答:结合代码、SDK 文档与网络行为盘点交叉核对。
07.1.1.11.3-080 应用包可见性与组件导出有什么上架要求?
一句话结论
高版本系统对应用间可见性与组件导出有明确要求:需要被其他应用调用的组件显式声明导出与意图过滤,无需对外的组件不导出;按包可见性声明查询其他应用。
概念解释
组件导出:Activity/Service/Receiver/Provider 声明 exported,带 intent filter 的组件需明确导出值。包可见性:查询设备其他应用需在 Manifest 声明可见性意图。错误的导出配置导致功能失效或审核问题。上架前核对组件导出与可见性声明。具体行为随系统版本(待确认)。
原理流程
组件用途梳理
→ exported 显式声明
→ 包可见性按需声明
代码或图示
<activity android:exported="false" ... />
常见误区
- 带 intent filter 未显式设置 exported,构建/校验报错。
- 无需对外的组件设为导出,暴露风险。
追问
- 如何排查组件导出配置问题?答:Manifest 合并报告核对各组件 exported 值。
- 包可见性声明影响什么?答:查询其他应用列表受限,需按用途配置
<queries>(待确认版本)。
07.1.1.11.3-081 通知与前台服务上架前要核对什么?
一句话结论
通知渠道、前台服务类型与相关权限需按高版本要求声明;后台启动限制与前台服务用途说明要齐备,避免功能受限或审核驳回。
概念解释
核对项:通知渠道创建与权限、前台服务类型声明、对应权限、后台启动与位置/相机等受限场景适配。高版本对后台服务与前台服务用途管控趋严。Manifest 声明与实际使用一致。上架前在目标版本验证通知与前台服务场景。具体类型枚举与限制随版本(待确认)。
原理流程
服务/通知场景梳理
→ 类型与权限声明
→ 目标版本验证
代码或图示
核对:foregroundServiceType / 权限 / 通知渠道 / 后台限制
常见误区
- 前台服务未声明类型,高版本启动受限。
- 通知渠道缺失,通知不展示。
追问
- 前台服务类型如何选择?答:按服务用途匹配官方类型枚举,不确定时核对文档(待确认)。
- 后台启动限制影响哪些场景?答:后台拉起 Activity/服务受限,见系统与稳定性章节。
07.1.1.11.3-082 应用图标、名称与元数据如何规范?
一句话结论
应用名称、图标、版本元数据在 Manifest 与商店后台保持一致;图标适配各密度与启动器规范,名称符合商店命名规则,避免误导性素材。
概念解释
素材核对:应用名、图标(多密度/自适应图标)、描述、截图、版本元数据。Manifest 与商店后台信息一致。图标符合启动器形状规范,名称不含违规或误导词汇。多语言名称按配置提供。素材随版本更新一致。审核常检查名称图标与实际功能是否相符。
原理流程
素材准备 → Manifest/商店信息核对
→ 多密度/多语言适配 → 提交
代码或图示
素材:icon / label / description / screenshots / metadata
常见误区
- 图标名称与功能不符,审核被质疑误导。
- 自适应图标未适配各形状,显示裁切异常。
追问
- 自适应图标由哪些层组成?答:前景与背景层,按启动器形状裁切,具体规范见官方文档。
- 商店素材与应用内名称不一致有何风险?答:审核驳回或用户认知混乱。
07.1.1.11.3-083 版本号与版本名如何规范管理?
一句话结论
versionCode 单调递增用于升级判定,versionName 面向用户展示;版本规则与发布节奏统一,CI 自动生成并记录,避免重复或回退。
概念解释
versionCode:整数,每次发布递增,系统据此判断升级。versionName:展示版本号(如语义化版本),可重复展示但 code 必须递增。规范:分支/构建号参与生成,记录版本与 commit 对应。热修复与灰度版本号规则明确。版本信息与归档、mapping 绑定。具体生成策略按团队约定(待确认)。
原理流程
发布版本规则 → CI 生成 versionCode/Name
→ 归档记录 → 商店填写
代码或图示
versionCode 递增;versionName 展示;二者与 commit 对应
常见误区
- versionCode 重复或回退,升级被拒。
- 版本名与实际构建对应不清,排查困难。
追问
- 灰度包版本号如何处理?答:灰度版本 code 递增且与全量版本衔接,规则提前约定。
- 如何追溯某版本对应代码?答:归档记录 commit 与构建号,版本映射可查。
07.1.1.11.3-084 上架审核常见驳回点有哪些?
一句话结论
常见驳回:权限/隐私不合规、目标 API 不达标、组件导出与可见性问题、素材与功能不符、崩溃兼容问题、签名/64 位缺失;发布前按清单逐项自查。
概念解释
驳回分类:合规类(隐私、权限、数据申报)、技术类(目标 API、64 位、崩溃、兼容)、素材类(名称图标描述不符)、签名类(证书/方案问题)。审核反馈逐条对照修复。建立上架自查清单,发布前过一遍。常见问题在 CI 与打包校验中前置拦截。具体审核标准以目标商店为准(待确认)。
原理流程
上架前自查清单
→ 合规/技术/素材/签名核对
→ 修复后提交
代码或图示
自查:privacy / permission / targetSdk / abi / crash / asset / sign
常见误区
- 只在被驳回后排查,未做前置自查。
- 驳回修复后未回归同类问题。
追问
- 如何沉淀驳回经验?答:把驳回点转为自查清单与 CI 校验项。
- 审核周期与版本节奏如何配合?答:预留审核时间,紧急修复走商店加急流程(待确认)。
07.1.1.11.3-085 分包交付与商店要求如何配合?
一句话结论
AAB 按设备拆分交付是主流方式;需确认商店支持 AAB、拆分配置正确,交付体积与设备覆盖符合预期,分包产物在上架前验证。
概念解释
交付形态:AAB 上传后商店拆分;部分场景使用多 APK 分包。核对商店对 AAB/分包的支持政策。拆分维度(ABI、密度、语言)配置正确。验证不同设备下载对应包。分包不影响签名一致性。具体商店分包政策与限制待确认。
原理流程
产物(AAB/多 APK) → 商店拆分规则
→ 设备匹配下载 → 验证覆盖与体积
代码或图示
交付:AAB split / multi-APK,按设备配置匹配
常见误区
- 商店不支持所选交付形态,上传失败。
- 拆分配置遗漏某设备档位,对应设备缺资源。
追问
- 如何验证拆分结果?答:按不同设备配置生成/查看对应 APK,核对 so 与资源。
- 分包后如何统计各包体积?答:按拆分维度分别记录下载体积。
07.1.1.11.3-086 加固、混淆与上架兼容性如何处理?
一句话结论
加固/加壳在混淆与打包后处理,需保证不破坏签名、R8 规则与运行兼容;加固包需重新签名并回归崩溃、启动与原生功能,上架前验证商店兼容。
概念解释
流程顺序:R8 混淆 → 加固处理 → 重新签名。加固可能改变 dex/so 结构,需核对混淆 keep 与 mapping 仍可用。加固后回归启动、崩溃、反调试与原生库加载。部分商店对加固有要求或限制。加固与混淆互补但不能替代 keep 规则正确性。具体加固工具行为按方案(待确认)。
原理流程
混淆产物 → 加固处理
→ 重签 → 回归兼容 → 上架验证
代码或图示
顺序:R8 → 加固 → 重签;回归:启动/崩溃/so/兼容
常见误区
- 加固后未重签,包签名失效。
- 加固导致 mapping 还原失效或原生库加载异常。
追问
- 加固后混淆栈还能还原吗?答:取决于加固方案对符号的处理,需核对 mapping 与脱壳支持(待确认)。
- 加固会影响性能吗?答:加载与运行期有额外开销,需实测启动与运行表现。
07.1.1.11.3-087 灰度上架与分阶段发布怎么做?
一句话结论
新版本先按比例/渠道灰度发布,监控崩溃、ANR、启动等指标,无异常再逐步放量;灰度版本可回退,放量决策基于线上数据。
概念解释
灰度流程:灰度包发布到小比例用户/渠道 → 监控核心指标(崩溃率、ANR、启动、核心链路)→ 观察期无异常逐步放量 → 全量。灰度版本与全量版本衔接,版本号与配置一致。异常时暂停放量或回滚。灰度覆盖典型设备与系统版本。分阶段节奏按风险评估。
原理流程
灰度发布 → 指标监控 → 逐步放量 / 回滚
代码或图示
阶段:canary → 小比例 → 分批放量 → full rollout
常见误区
- 灰度观察期不足,问题随放量扩散。
- 灰度版本指标与全量版本不区分,误判。
追问
- 灰度期间看哪些指标?答:崩溃率、ANR、启动时长、核心业务转化,见稳定性章节。
- 灰度版本如何回退?答:停止放量 + 引导老版本或修复包,按商店能力处理(待确认)。
07.1.1.11.3-088 上架后版本更新与回滚如何管理?
一句话结论
更新按版本节奏推送,线上版本分布持续跟踪;出现严重问题时通过修复包更新或商店回滚/下架处理,数据与版本记录支撑应急决策。
概念解释
更新管理:各线上版本分布、遗留版本 mapping 保留、修复版本号衔接。回滚手段:商店允许的下架/退回版本、发布修复包强制更新。严重问题应急:先止血(下架/灰度暂停),再定位修复。老用户长期停留版本需保留符号化与支持策略。回滚能力依赖商店机制。
原理流程
线上版本分布监控
→ 严重问题 → 止血(下架/暂停) → 修复包更新
代码或图示
管理:version distribution / mapping 保留 / hotfix / rollback
常见误区
- 清理旧版本 mapping,遗留线上崩溃无法还原。
- 回滚只靠应用内逻辑,未利用商店版本机制。
追问
- 强制更新如何实现?答:服务端下发最低版本要求,低版本引导升级,见业务流程。
- 如何掌握线上版本分布?答:崩溃/安装数据按版本号聚合统计。
07.1.1.11.3-089 包体监控如何做版本对比?
一句话结论
持续记录各版本分项体积,自动对比增量与来源,超阈值告警;包体趋势纳入发布看板,防止随迭代持续膨胀。
概念解释
监控数据:每版本代码/so/资源/媒体体积与总包体,按 ABI 与交付形态。对比上一版本增量,定位增长模块/依赖/资源。趋势看板观察长期膨胀。新增大依赖或资源在评审时预估体积。监控与门禁结合,增量异常拦截。
原理流程
各版本分项体积入库
→ 增量对比 / 趋势看板
→ 超阈值告警
代码或图示
监控:per-version size breakdown + delta + trend
常见误区
- 只在发版时手动看体积,无历史趋势。
- 体积增长未关联到具体依赖/资源,无法治理。
追问
- 包体增长归因怎么做?答:对比两版本依赖树与资源清单,定位新增项。
- 体积指标按什么口径展示?答:区分下载与安装体积,口径统一记录。
07.1.1.11.3-090 混淆规则如何评审与维护?
一句话结论
keep 规则随代码评审维护:新增反射/序列化/桥/JNI 调用同步补规则,规则注释说明原因;定期清理过宽规则,release 回归验证混淆路径。
概念解释
评审要点:动态调用点是否有对应 keep;规则是否过宽;模型/桥/JNI 覆盖是否完整;第三方库规则是否缺失。维护:代码变更时同步规则;定期审查规则与保留代码量。release 包走核心路径回归。规则文件注释保留原因便于后人理解。混淆问题反馈到规则补充。
原理流程
动态调用点识别 → 规则补充
→ 评审宽度 → release 回归验证
代码或图示
维护:review keep / 清理过宽 / 注释原因 / 回归
常见误区
- 规则长期不评审,越积越宽。
- 新增动态调用未补规则,上线后崩溃。
追问
- 如何发现过宽规则?答:统计被保留代码量,收窄到实际动态目标。
- 混淆规则冲突如何处理?答:合并重复规则,明确保留优先级。
07.1.1.11.3-091 第三方依赖如何裁剪与瘦身?
一句话结论
盘点三方库的功能必要性、重复能力与体积贡献,移除冗余库、替换轻量替代、按需引入模块;三方库的权限、资源与 so 一并评估。
概念解释
裁剪思路:依赖树找重复/未用库;评估库的功能是否被其他库覆盖;大库能否用轻量替代或按需模块引入;三方 so 与资源纳入包体分析。升级库版本获取体积优化。三方 SDK 行为与合规一并核对。移除依赖前确认无隐式引用。
原理流程
依赖清单 → 功能/体积/重复评估
→ 移除/替代/按需引入
→ 回归验证
代码或图示
裁剪:unused / duplicate / heavy alternative / modular include
常见误区
- 一个功能引入整库,未用模块占体积。
- 只看代码体积,忽略三方 so 与资源贡献。
追问
- 库的部分能力如何按需引入?答:按库提供的模块化坐标拆分引入,具体以库文档为准。
- 替换三方库风险如何控制?答:对照功能清单迁移,核心路径回归测试。
07.1.1.11.3-092 资源命名与组织规范对包体有何帮助?
一句话结论
统一资源命名与目录规范可减少重复资源、便于检索清理;配合资源引用约定,降低冗余资源累积,支撑资源压缩准确判定。
概念解释
规范要点:资源命名按模块/功能前缀,目录按类型组织,避免同名多份重复切片;字符串/样式集中管理;新增资源先查重。规范让资源引用可追踪,减少动态名隐式引用。资源命名不直接压缩文件,但为清理与分析打基础。规范随代码评审执行。
原理流程
命名/目录规范
→ 减少重复与隐式引用
→ 资源清理可追踪
代码或图示
规范:prefix / type dir / 查重 / 集中管理
常见误区
- 资源命名随意,重复切片难发现。
- 资源散落 assets,清理时漏盘。
追问
- 重复图片如何识别?答:按文件名、尺寸与内容哈希比对。
- 资源规范如何落地?答:评审检查 + 资源扫描工具辅助。
07.1.1.11.3-093 构建产物与本地缓存如何清理?
一句话结论
定期清理构建中间产物与过期缓存,避免磁盘占用与脏缓存导致的构建异常;清理不影响源码,产物归档后可安全删除本地中间输出。
概念解释
清理对象:构建目录中间产物、过期缓存、旧版本产物与临时分析文件。归档后的发布产物与 mapping 不删。缓存清理用于解决脏缓存问题。清理操作在本地与 CI 环境分别管理。不要清理已归档的 mapping 与发布包。清理后首次构建缓存重建,耗时上升属正常。
原理流程
识别中间产物/过期缓存
→ 清理(保留归档产物与 mapping)
→ 重建验证
代码或图示
清理:build 中间物 / 过期缓存 / 旧产物;保留:归档包 + mapping
常见误区
- 把归档 mapping 当缓存删掉,线上栈不可还原。
- 频繁清缓存导致构建耗时无谓上升。
追问
- 脏缓存有什么表现?答:改代码后产物未更新、行为异常,清缓存重建可验证。
- CI 缓存如何定期清理?答:按保留策略过期清理,避免缓存无限增长。
07.1.1.11.3-094 多模块结构如何影响包体?
一句话结论
模块拆分影响依赖复用与代码裁剪:公共模块被多模块复用以避免重复打包,模块边界清晰利于 R8 按可达性收缩;不合理的模块划分可能带来重复依赖与额外开销。
概念解释
多模块收益:公共能力下沉复用,避免各业务模块重复打包相同代码;边界清晰便于独立构建与裁剪。风险:模块间重复依赖、公共模块过度膨胀、实现重复。R8 在整体产物上做收缩,模块结构影响可达性分析与缓存。模块划分结合业务边界与构建效率。
原理流程
公共能力下沉复用
→ 模块边界清晰
→ R8 收缩 / 缓存命中
代码或图示
影响:复用去重 / 收缩可达性 / 构建缓存 / 重复依赖风险
常见误区
- 各业务模块各自引入相同库,代码重复打包。
- 公共模块塞入大量非公共代码,体积膨胀。
追问
- 模块拆分能直接减小包体吗?答:通过复用去重与收缩间接减小,需实测对比。
- 如何发现跨模块重复代码?答:依赖树与代码重复扫描结合定位。
07.1.1.11.3-095 混淆导致的运行时问题如何排查?
一句话结论
混淆后运行问题多为符号被改名/收缩:先在 debug 包复现逻辑,线上用 mapping 还原堆栈,对照反射/序列化/桥/JNI 调用点补 keep,再回归 release 包。
概念解释
排查路径:崩溃/找不到类方法 → mapping 还原定位原始符号 → 核对该符号的动态调用方式 → 判断被收缩还是被改名 → 补对应 keep 规则。常见现象:反射失败、解析丢字段、JS 桥无响应、JNI 链接失败。先复现确认非逻辑 bug,再区分混淆因素。规则补充后重新构建 release 验证。
原理流程
混淆异常 → mapping 还原
→ 定位动态调用点
→ 补 keep → release 回归
代码或图示
排查:debug 复现 / mapping 还原 / 调用点核对 / 规则修复
常见误区
- 未还原 mapping 直接按短名猜源码位置。
- 只补类 keep,遗漏方法/字段成员规则。
追问
- 如何判断是被收缩还是被改名?答:类不存在多为收缩;类在但方法/字段找不到多为改名。
- 修复后如何防回归?答:把该动态路径加入 release 回归用例。
07.1.1.11.3-096 签名密钥应急流程如何制定?
一句话结论
预先制定密钥丢失/泄露应急流程:评估影响、按 v3 轮换或换包方案处置、更新平台登记指纹、通知相关方;日常做好备份、访问审计与最小授权。
概念解释
应急步骤:发现丢失/泄露 → 评估影响范围 → 受控环境确认密钥状态 → 可轮换则走 v3 密钥轮换,不可轮换则规划换包迁移 → 更新开放平台/SDK 登记指纹 → 监测仿冒包。日常预防:密钥库备份、口令分级、访问审计、定期检查。应急流程文档化并演练。具体轮换与商店处置政策待确认。
原理流程
异常发现 → 影响评估
→ 轮换 / 换包 → 更新登记 → 监测
代码或图示
应急:assess → rotate/repackage → update registry → monitor
常见误区
- 无应急流程,泄露后临时决策贻误处置。
- 轮换后未更新各平台登记指纹,接入校验失败。
追问
- 密钥备份应保存几份、存哪里?答:离线受控多份备份,访问受限,具体按团队安全规范。
- 如何监测仿冒包?答:按包名与签名指纹比对渠道上架包,发现异常下架处理。
07.1.1.11.3-097 什么是可复现构建,如何保障?
一句话结论
可复现构建指相同源码、依赖与配置在不同环境产出一致(或可比对)的产物;通过锁定依赖版本、固化环境与配置、记录构建元数据实现,便于追溯与排障。
概念解释
保障要素:依赖版本锁定、工具链版本固定、构建配置纳入版本管理、环境一致、产物与 commit 对应记录。产物字节级一致受时间戳等因素影响,实践中以可追溯与可比对为准。可复现支持问题复现与审计。CI 环境固化是关键。具体可复现程度受构建工具链限制(待确认)。
原理流程
源码 + 锁定依赖 + 固定工具链
→ 一致环境构建
→ 产物与元数据对应
代码或图示
保障:lock deps / fixed toolchain / checked config / metadata
常见误区
- 依赖版本浮动,不同环境解析到不同库。
- 构建配置只存在本地,CI 与本地产物不一致。
追问
- 如何核对两次构建产物一致性?答:比对产物 hash 与分项构成,差异项定位来源。
- 可复现与构建缓存冲突吗?答:不冲突,缓存复用需保证输入一致。
07.1.1.11.3-098 上架材料与版本记录如何管理?
一句话结论
上架材料(应用描述、截图、隐私政策、数据安全表单、版本说明)与版本记录统一归档,随版本更新;材料与应用实际行为一致,发布记录可追溯。
概念解释
材料管理:商店后台文案、截图视频、隐私政策链接、数据安全申报、更新说明。版本记录:版本号、commit、产物、mapping、材料版本、发布时间与渠道。材料随功能变更同步更新。归档便于历史版本追溯与审核复查。材料与代码行为一致性纳入发布检查。
原理流程
版本功能变更
→ 材料同步更新
→ 材料/产物/版本记录归档
代码或图示
归档:release notes / screenshots / policy / form / build record
常见误区
- 更新说明与实际功能不符,审核或用户投诉。
- 材料版本与应用版本对应不清,复查困难。
追问
- 隐私政策版本如何记录?答:政策更新日期与应用版本对应归档。
- 多渠道材料需要分别维护吗?答:核心材料统一,渠道差异部分单独记录。
07.1.1.11.3-099 包体、混淆、签名在发布流程中如何串联?
一句话结论
三者构成发布质量链路:R8 收缩混淆减小包体并保护代码,产物经签名保证身份与完整性,包体指标与签名校验纳入 CI 门禁,最终一致地产出可上架包。
概念解释
串联关系:代码收缩混淆影响包体与 mapping 归档;签名在混淆/加固后对最终产物生效;包体分析核对收缩与裁剪收益;mapping 与签名证书都按版本归档。流程顺序:构建 → R8 → 资源/so 裁剪 → 加固(可选) → 签名 → 校验归档。任一环节异常阻断发布。理解链路有助于定位发布问题归属。
原理流程
构建 → R8 收缩混淆 → 资源/so 裁剪
→ 加固(可选) → 签名 → 校验归档
代码或图示
链路:shrink/obfuscate → size check → sign → verify/archive
常见误区
- 混淆后加固未重签,签名失效。
- 包体分析用未混淆 debug 产物,口径错误。
追问
- mapping 与签名证书归档有何共同点?答:都按版本绑定归档,支撑线上还原与身份核对。
- 发布问题如何归属环节?答:按崩溃符号、签名校验、包体异常分别定位对应环节。
07.1.1.11.3-100 发布前稳定性检查清单包含哪些项?
一句话结论
发布清单覆盖代码收缩混淆、包体与 ABI、签名与密钥、合规权限隐私、产物校验、测试回归与归档记录;逐项核对通过后再进入上架流程。
概念解释
清单分组:
- 代码:R8 开启、keep 规则评审、mapping 归档。
- 包体:分项体积基线、so ABI 与 64 位、资源图片优化。
- 签名:发布证书、方案组合、密钥安全、渠道包签名一致。
- 合规:targetSdk、权限最小化、隐私政策与数据申报、组件导出。
- 质量:核心测试回归、崩溃/ANR 监控基线、产物可安装校验。
- 记录:版本号、产物、mapping、材料归档可追溯。
清单随政策与项目演进更新,发布前逐项勾选。
原理流程
分组核对清单
→ 异常修复复测
→ 归档记录 → 上架
代码或图示
checklist: r8/keep/mapping · size/abi · sign/key · compliance · test/monitor · archive
常见误区
- 清单流于形式,关键项未实际验证。
- 清单未随新政策更新,遗漏新要求。
追问
- 清单如何沉淀到 CI?答:可自动化的项接入门禁,人工项保留发布前核对。
- 历史发布问题如何反哺清单?答:驳回与线上问题归类补充到对应检查项。
参考来源
- Android 官方文档:收缩代码与 R8(Shrink your code with R8):https://developer.android.com/build/shrink-code
- Android 官方文档:Android App Bundle 概览:https://developer.android.com/build/app-bundle
- Android 官方文档:应用签名(App signing):https://developer.android.com/privacy-and-security/app-signing
- Android NDK 文档:ABI 管理与原生库架构:https://developer.android.com/ndk/guides/abis
- Android 官方文档:发布应用到 Google Play(Publish your app):https://developer.android.com/studio/publish
待整理清单
- [ ] 核对目标商店当前 targetSdk、64 位与分包政策的具体数值与截止时间(待确认)
- [ ] 核对 AGP 8.x 下签名方案开关、资源 keep 规则与 v4 签名产物的准确 DSL 名称(待确认)
- [ ] 补充项目实际使用的加固/多渠道打包方案及其重签与 mapping 兼容细节(待确认)
- [ ] 整理 R8 常用 keep 规则模板与第三方库规则来源清单
- [ ] 建立包体分项体积基线与版本对比记录样例
- [ ] 完善发布前检查清单与 CI 门禁项映射表