R8未混淆指定类的原因及保留可达类并混淆的配置方法

4. **configuration.txt**：未提及该类，且其他同类型类已被混淆，说明无全局保留规则

### 补充信息
- 已通过ProGuard测试工具验证，无针对该类的显式保留规则
- 该类无父类，仅依赖Moshi库，相关属性已正常混淆

### 需求
保留该类（业务确有依赖），但**混淆其类名**；同时希望配置R8实现：保留所有可达类并自动混淆，仅当类被`@Keep`注解或ProGuard规则显式保留时例外。请问该需求是否可行，如何实现？

---

## 解决方案
### 可行性结论
完全可行。R8的默认行为就是保留所有可达类并自动混淆，仅当存在显式保留规则（`@Keep`注解或ProGuard规则）时才会跳过混淆。当前问题的核心是TokenStorage类被**隐式规则**阻止了类名混淆，只需排查并解除该限制即可。

### 具体实现步骤
1. **排查隐式保留原因**
TokenStorage类名未混淆但属性正常，大概率是被**反射逻辑**或**第三方库（如Moshi）**的隐式规则保留了类名。比如Moshi若通过`@JsonClass`注解生成适配器，R8默认会保留原类名，需添加规则允许混淆。

2. **添加ProGuard规则强制混淆类名**
在ProGuard规则文件中添加以下规则，确保TokenStorage类名可被混淆，同时保留业务必需的构造方法和成员：
```proguard
# 保留TokenStorage的可达性，但允许混淆类名，仅保留必要构造方法
-keepnames class com.package.storage.TokenStorage {
 <init>(com.package.storage.StorageDelegate);
 # 若有其他被反射调用的方法/属性，需单独保留，否则可省略
}

# 全局规则：仅保留被@Keep标记的类名，其他可达类允许混淆
-keepnames @androidx.annotation.Keep class *

注：-keepnames仅保留类/成员的名称（防止混淆），但未被使用的类/成员仍会被移除；而-keep会强制保留类/成员及其名称。此处用-keepnames配合R8的可达性分析，既保留业务依赖的类，又允许混淆未被显式保护的类名。

3. 适配Moshi相关配置
   如果TokenStorage涉及Moshi序列化，需调整Moshi的ProGuard规则，允许混淆类名：

# 保留Moshi注解的字段，允许混淆类名
-keepclassmembers class * {
    @com.squareup.moshi.JsonField <fields>;
}

# 保留@JsonClass标记的类的构造方法，但允许混淆类名
-keep @com.squareup.moshi.JsonClass class * {
    <init>(...);
}

4. 全局配置校验
   确保ProGuard规则中没有全局保留类名的规则（如-keepnames class *），同时保持minifyEnabled true和shrinkResources true正常生效，即可实现「保留所有可达类并自动混淆，仅显式规则例外」的目标。

验证方式 #

修改规则后重新构建项目，检查：

• mapping.txt：确认com.package.storage.TokenStorage已被映射为短类名（如com.package.storage.a）
• seeds.txt：该类仍会出现在列表中（因属于可达类），但显示混淆后的名称
• 运行应用：验证TokenStorage相关功能正常，无反射或序列化异常

内容的提问来源于stack exchange，提问作者Emanuel Moecklin