Android构建时如何完全移除未使用的资源而非替换为占位文件

这不是配置错误，是你当前使用的Android Gradle Plugin（AGP）版本下，资源收缩机制的默认设计限制：

• 资源收缩功能会先通过全量扫描，识别项目代码、布局、资源文件中实际引用的所有资源，标记出未被引用的闲置资源
• 对于主app模块自身的未使用资源，严格收缩模式下可以直接从最终APK中完全删除
• 对于来自外部依赖（包括本地项目依赖、远程AAR依赖）的未使用资源，由于旧版本构建逻辑的兼容考虑，AGP不会直接删除对应的资源文件实体。你当前使用的AGP 4.1版本默认开启传递式R类生成机制，每个依赖库的所有资源ID都会在构建期合并到全局R类索引中，如果直接删除资源文件，会导致已生成的R类ID映射错位，甚至引发运行时资源找不到的崩溃问题
• 为了兼顾体积缩减和构建稳定性，AGP会把识别到的未使用依赖资源，替换成内容为<x />的极小体积空占位文件，也就是构建日志中记录的“替换为104字节占位文件”的处理逻辑。这种处理既压缩了原始资源的体积，又不会破坏已有的R类ID索引结构，是为兼容旧构建逻辑设计的兜底方案
• 你配置的空proguard-rules.pro不会影响资源收缩的扫描准确性，只要minifyEnabled和shrinkResources同时开启，资源引用关系的扫描逻辑就可以正常运行，这不是导致占位替换的原因
• 你在keep.xml中配置的tools:keep="@raw/*"本身是将raw目录所有资源标记为强制保留，但由于这些被替换的形状XML资源不在raw目录下，自然不受该配置的影响，因此加不加这行配置的处理结果都没有区别。

由于默认资源收缩机制的设计限制，要跳过占位替换、直接删除未使用资源，需要对应调整构建配置或流程：

• 升级AGP版本到7.0及以上，同时在项目的gradle.properties中开启android.nonTransitiveRClass=true、android.nonFinalResIds=true配置。这两个配置开启后，依赖库的R类不会再将全量资源ID传递到主app模块的全局索引，主app的R类只会收集实际被引用的资源ID，此时AGP的资源收缩逻辑就可以直接删除未被引用的依赖资源文件，不再生成占位内容
• 如果不想升级AGP版本，可以在构建流程中增加后置处理任务：在release构建完成、APK签名对齐之前，通过脚本遍历APK压缩包内的所有资源文件，将所有内容为<x />的占位资源条目直接从APK中移除，再重新执行压缩、对齐、签名流程。这种方式不需要修改原有项目的依赖结构，只补全旧版本AGP没有覆盖的删除逻辑即可
• 如果资源库的依赖范围可控，也可以在依赖引入时做精准的资源过滤，只引入实际需要用到的资源条目，从构建源头上减少需要处理的未使用资源规模，但由于你的资源是持续随机生成更新的，这种方式的长期维护成本会比较高。

内容的提问来源于stack exchange，提问作者H.Kim