package-info.java对ProGuard的影响机制及原因探究

原理解析 #

ProGuard的默认混淆逻辑里，package-info.java是触发包层级保留的关键信号：

• 当一个包没有package-info.java时，ProGuard会对这个包做「扁平化混淆」：类名会被压缩成最短的单字符（比如a），成员变量/方法也直接用a、b这类无层级的短标识符，完全丢弃原包名的关联。
• 当包内存在package-info.java时，ProGuard会认为这个包的结构需要被保留层级关联，混淆时会保留完整的包名前缀，仅将类名替换为短标识符（比如com.example.a），成员则会带上「包名+类名」的前缀（比如com.example.a.a）。

本质上，package-info.java是Java官方定义的包级元数据载体，ProGuard的默认规则将其视为「该包需要维持命名空间层级」的标记，避免对整个包的命名做彻底扁平化处理。

针对库的局部解决方案 #

因为你交付的是库，不想通过全局的-keeppackagenames规则影响所有包，这里有两种精准的局部处理方式：

方式1：给目标类所在包添加空的package-info.java #

这是最轻量化的方案：只需要在出问题的新类所在的包（比如com.example）下创建一个package-info.java文件，内容可以极简，甚至只保留包声明：

package com.example;

这样只会让这个包下的类采用带完整包名的混淆形式，不会影响库中其他包的混淆逻辑，完全符合你「仅针对出问题的新类修改」的需求。

方式2：精准的ProGuard规则（替代package-info.java） #

如果不想新增文件，可以在ProGuard规则中给目标类所在的包单独设置保留规则：

# 仅保留目标类所在包的包名，不影响其他包
-keeppackagenames com.example
# 确保目标类的成员也遵循带包名的混淆逻辑
-keepclassmembers class com.example.Something { *; }

不过这种方式需要明确指定包名，不如添加package-info.java来得直观和低侵入。

内容的提问来源于stack exchange，提问作者Bill Mote