release模式构建签名AAB/APK报错Unresolved reference viewModels如何解决？

问题产生原因 #

该问题由debug和release构建的配置差异触发，核心原因如下：

• debug构建默认关闭R8混淆、资源压缩逻辑，不会移除未被显式标记的注解生成类、Kotlin扩展方法；release构建开启minifyEnabled后，R8会误将Hilt生成的注入类、by viewModels依赖的Fragment KTX扩展方法判定为无用代码裁剪，或是混淆类名、方法名导致引用找不到
• 引入Google GMS依赖后可能触发依赖版本冲突，将Fragment KTX、Lifecycle相关依赖覆盖为不兼容的低版本，导致扩展方法失效

问题出现位置 #

• release构建流程的R8混淆/代码优化阶段，触发点为构建签名AAB/APK时的编译校验环节
• 具体关联的配置项为app模块build.gradle中release构建类型的minifyEnabled true配置
• 报错代码行均为标注了@AndroidEntryPoint的Fragment中调用by viewModels扩展方法的位置

解决方案 #

• 补充混淆规则
  在app模块的proguard-rules.pro文件中添加如下规则，避免核心类被裁剪混淆：

# Hilt 核心混淆规则
-keep class dagger.hilt.** { *; }
-keep class * extends dagger.hilt.internal.GeneratedComponent
-keep @dagger.hilt.AndroidEntryPoint class * { *; }
-keep class * extends dagger.hilt.android.components.ViewModelComponent

# ViewModel 及 Fragment KTX 规则
-keep class androidx.lifecycle.ViewModel { *; }
-keepclassmembers class * extends androidx.lifecycle.ViewModel {
    <init>(...);
}
-keepnames class androidx.fragment.app.FragmentKt
-keepclassmembers class androidx.fragment.app.FragmentKt {
    public static <methods>;
}

# GMS 兼容规则
-keep class com.google.android.gms.** { *; }
-dontwarn com.google.android.gms.**

• 校验依赖配置

1. 确认androidx.fragment:fragment-ktx、androidx.lifecycle:lifecycle-viewmodel-ktx依赖使用implementation声明，而非仅对debug生效的debugImplementation
2. 检查app模块build.gradle已正确引入Hilt插件：

plugins {
    id 'com.android.application'
    id 'kotlin-android'
    id 'kotlin-kapt'
    id 'dagger.hilt.android.plugin'
}

• 解决依赖冲突
  如果GMS依赖覆盖了核心库版本，在app模块build.gradle中添加强制版本配置：

configurations.all {
    resolutionStrategy {
        // 替换为项目中使用的兼容版本即可
        force "androidx.fragment:fragment-ktx:1.6.1"
        force "androidx.lifecycle:lifecycle-viewmodel-ktx:2.6.2"
    }
}

• 问题定位校验
  临时将release构建的minifyEnabled改为false后重新构建，如果不再报错即可确认是混淆规则缺失导致的问题，无需修改其他业务代码。

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