重建Android项目时遇报错：:app:transformClassesWithDexForDebug任务执行失败

哦，这个错误我太熟悉了！说白了就是你的项目（包括你引入的所有第三方库）里的方法总数突破了单个Dex文件的上限——65536个，Dalvik虚拟机（以及早期的ART）单个Dex最多只能装这么多方法，所以就抛出这个异常了。别慌，下面给你一步步解决：

核心解决方案：开启Multidex支持 #

Multidex就是让你的APK能包含多个Dex文件，这样就能装下更多方法了，配置起来很简单：

1. 添加Multidex依赖
   在你的app模块下的build.gradle文件里，给dependencies块加上Multidex的依赖：

   • 如果你用的是Android Support库：

     implementation 'com.android.support:multidex:1.0.3'
     

   • 如果你已经迁移到AndroidX：

     implementation 'androidx.multidex:multidex:2.0.1'
     

2. 启用Multidex编译选项
   同样在app的build.gradle的defaultConfig块里，加上这一行：

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

3. 配置Application类
   这一步分两种情况：

   • 如果你没有自定义Application类：直接在AndroidManifest.xml的<application>标签里指定系统的Multidex Application：

     <application
         // 其他属性...
         android:name="android.support.multidex.MultiDexApplication"> <!-- AndroidX的话换成androidx.multidex.MultiDexApplication -->
         // 其他内容...
     </application>
     

   • 如果你有自定义的Application类：要么让它继承MultiDexApplication（或者AndroidX对应的类），要么在attachBaseContext方法里手动初始化Multidex：

     public class MyApplication extends Application {
         @Override
         protected void attachBaseContext(Context base) {
             super.attachBaseContext(base);
             MultiDex.install(this);
         }
     }
     

     记得在Manifest里把android:name改成你的自定义Application类名。

额外优化：减少方法数（从根源避免问题） #

开启Multidex能解决问题，但如果能减少项目的方法总数，性能会更好，也能避免后续可能的其他问题：

• 清理无用依赖：检查你的build.gradle，把那些你根本没用到的库删掉；有些库有拆分的模块，比如只需要用OkHttp的某个功能，就别引入整个OkHttp包，只引需要的模块。
• 用R8/ProGuard混淆压缩：在release构建里开启混淆（debug也可以开，但不建议），R8会自动移除未使用的代码，大幅减少方法数。在build.gradle的buildTypes块里配置：

  buildTypes {
      release {
          minifyEnabled true
          proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
      }
  }
  

• 检查重复依赖：用命令./gradlew app:dependencies（Windows上是gradlew.bat app:dependencies）生成依赖树，看看有没有重复引入的库，比如多个依赖都引入了同一个版本的支持库，用exclude去掉重复的部分。

注意事项 #

• 如果你的minSdkVersion低于21，Multidex的初始化必须正确，否则在低版本设备上可能会崩溃。
• 测试的时候，如果用了Instrumented Tests，也要在测试的Application里配置Multidex，或者在测试类里初始化。

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