移除Google Play服务依赖后ClassNotFoundException及MultiDex失效求助

这种情况我在调整依赖后碰到过好几次，虽然你已经开启了MultiDex，但移除Google Play服务依赖的操作可能触发了构建缓存、Dex打包配置或者混淆规则的隐性问题，以下是几个针对性的排查和解决步骤：

1. 彻底清理构建缓存 #

依赖变更后，旧的构建缓存很容易导致Dex打包异常，先做彻底清理：

• 执行终端命令：./gradlew clean
• 打开Android Studio，点击菜单栏的File -> Invalidate Caches...，选择Invalidate and Restart，让IDE完全重置缓存

2. 重新校验MultiDex的完整配置 #

确认所有MultiDex相关配置没有遗漏或被变体覆盖：

• 在模块的build.gradle的defaultConfig块中确保开启：

  defaultConfig {
      // 其他配置...
      multiDexEnabled true
  }
  

• 确认依赖中包含最新版的MultiDex库：

  dependencies {
      implementation 'androidx.multidex:multidex:2.0.1'
  }
  

• 检查自定义Application类：
  • 如果你的MyApplication继承自Application，修改为继承MultiDexApplication：

    public class MyApplication extends MultiDexApplication {
        // 你的代码...
    }
    

  • 或者如果无法修改父类，在attachBaseContext方法中手动初始化MultiDex：

    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        MultiDex.install(this);
    }
    

  • 如果没有自定义Application，确保在AndroidManifest.xml的<application>标签中指定MultiDexApplication：

    <application
        android:name="androidx.multidex.MultiDexApplication"
        // 其他属性...>
    </application>
    

3. 检查混淆/压缩规则（ProGuard/R8） #

移除Google Play服务时，可能不小心修改了混淆规则，导致MyApplication被误删或混淆：

• 在proguard-rules.pro中添加显式的keep规则：

  -keep class com.app.yukngaji.MyApplication { *; }
  -keep class androidx.multidex.** { *; }
  

• 确认build.gradle中的minifyEnabled如果为true，没有遗漏必要的keep规则，尤其是Application类

4. 检查构建变体的单独配置 #

你的应用使用了sandbox产品风味，要确认该变体没有单独关闭MultiDex：

• 查看build.gradle中的productFlavors或buildTypes块，确保sandbox变体的multiDexEnabled没有被设置为false：

  productFlavors {
      sandbox {
          // 其他配置...
          multiDexEnabled true // 必须确保这里是true
      }
  }
  

5. 验证APK中的Dex内容 #

最后确认打包后的APK是否包含MyApplication类：

• 点击Android Studio菜单栏的Build -> Analyze APK，选择生成的base.apk
• 在弹出的窗口中查看classes.dex（或多个Dex文件），搜索com.app.yukngaji.MyApplication，如果找不到，说明打包时该类没有被包含，需要检查sourceSets配置是否正确，或者变体的代码目录是否有问题

这些步骤覆盖了依赖调整后导致ClassNotFound的常见场景，尤其是缓存和配置遗漏的问题，你可以一步步排查试试。

内容的提问来源于stack exchange，提问作者Firdaus The Gamer