开启minifyEnabled后签名APK的FirestoreRecyclerAdapter显示空白

这个问题我之前也踩过坑，核心原因就是代码混淆（minify）破坏了Firestore的数据映射机制。FirestoreRecyclerAdapter依赖Firestore自动将文档数据映射到你的实体类（比如你的TransactionRecycler），但开启minify后，ProGuard会重命名实体类的字段、甚至移除它认为“未被引用”的代码，导致Firestore找不到对应的字段，自然加载不出数据，RecyclerView就空白了。

下面是几种可行的解决方案，按推荐程度排序：

方案1：为实体类添加@Keep注解 #

最简单的方式是直接在你的TransactionRecycler类和它的字段上添加@Keep注解，告诉ProGuard不要混淆这些内容：

import androidx.annotation.Keep;

@Keep
public class TransactionRecycler { 
    @Keep
    private String payment_method;
    @Keep
    private double amount;
    // 其他字段、构造方法和业务方法...
}

这样ProGuard会完整保留这个类和所有标记了@Keep的元素，Firestore就能正常完成数据映射了。

方案2：在proguard-rules.pro中添加混淆规则 #

如果你不想在代码里加注解，可以在项目的proguard-rules.pro文件中添加规则，强制保留你的实体类及其字段：

# 保留TransactionRecycler类和它的所有成员
-keep class com.yourpackage.TransactionRecycler { *; }

# 如果还有其他Firestore实体类，按同样格式添加
-keep class com.yourpackage.OtherFirestoreEntity { *; }

注意把com.yourpackage替换成你实际的包名。

另外，建议补充Firestore核心库的通用混淆规则，避免库本身的核心逻辑被破坏：

# 保留Firestore相关类与注解，保障核心功能正常
-keep class com.google.firebase.firestore.** { *; }
-keepnames class com.google.firebase.firestore.** { *; }
-keepattributes *Annotation*

方案3：结合@PropertyName注解（可选） #

如果你的实体类字段名和Firestore文档的字段名不一致（比如用了驼峰命名），可以配合@PropertyName注解明确指定映射关系，同时搭配上面的混淆规则使用：

public class TransactionRecycler { 
    @PropertyName("payment_method")
    private String paymentMethod;

    // 对应的getter/setter也要添加注解
    @PropertyName("payment_method")
    public String getPaymentMethod() { return paymentMethod; }
    
    @PropertyName("payment_method")
    public void setPaymentMethod(String paymentMethod) { this.paymentMethod = paymentMethod; }
}

这种方式能进一步确保字段映射的准确性，不过还是优先推荐前两种方案直接保留字段名。

最后，记得重新生成签名APK测试，应该就能正常显示数据了！

内容的提问来源于stack exchange，提问作者Ibrahim Usman