如何解决调试构建中的64K引用限制问题？

针对你遇到的minSdkVersion降至19后，独立调试构建（如CI）或Android 5.0以下设备调试时触发64K方法数限制的问题，以下是几个更优雅的解决方案，无需手动频繁修改Gradle配置：

1. 针对CI环境自动启用轻量调试压缩 #

通过环境变量区分CI和本地开发环境，仅在CI构建时启用轻量R8压缩（只压缩方法，不处理资源，兼顾速度和方法数缩减），本地开发保持无压缩的高性能状态：

配置build.gradle（Module级别） #

android {
    buildTypes {
        debug {
            // 读取CI环境变量（GitHub Actions默认会设置CI=true）
            def isCiBuild = System.getenv("CI") == "true"
            
            minifyEnabled isCiBuild
            shrinkResources false // 关闭资源压缩，加快CI构建速度
            multiDexEnabled true // 兜底支持pre-5.0设备
            
            if (isCiBuild) {
                proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules-debug.pro'
            }
        }
    }
}

配套调试ProGuard规则（proguard-rules-debug.pro） #

保留调试必要信息，避免影响调试体验：

# 保留源码文件和行号，方便调试
-keepattributes SourceFile,LineNumberTable
# 保留自身所有类和方法，仅压缩第三方依赖
-keep class com.your.app.package.** { *; }
# 忽略第三方依赖的警告
-dontwarn **

2. 最小化Multidex配置，仅针对pre-5.0设备 #

Android 5.0（API 21）及以上系统默认支持ART虚拟机的原生多Dex，无需额外配置。仅针对API 20及以下设备启用Multidex，且改动极小：

步骤1：添加Multidex依赖 #

// 仅在debug构建中引入，release已有R8压缩无需
debugImplementation 'androidx.multidex:multidex:2.0.1'

步骤2：配置build.gradle #

android {
    defaultConfig {
        // 仅当minSdk<=20时启用Multidex
        multiDexEnabled project.android.defaultConfig.minSdkVersion <= 20
    }
}

步骤3：修改Application类（二选一） #

• 若使用自定义Application，继承MultiDexApplication：

  public class MyApp extends MultiDexApplication {
      // 原有代码不变
  }
  

• 若无法继承，在attachBaseContext中调用Multidex初始化：

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

此改动仅影响API 20及以下设备，对高版本无性能损耗，且代码侵入性极低。

3. 清理冗余依赖，减少方法数 #

即使依赖不多，也可排查间接依赖的冗余模块：

• 执行./gradlew app:dependencies查看依赖树，找出不必要的子模块并排除：

  implementation('com.example.library:core:1.0.0') {
      exclude group: 'com.example.unneeded', module: 'module'
  }
  

• CI构建时替换调试工具为无实现版本（如LeakCanary的no-op版本）：

  debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.12'
  if (System.getenv("CI") == "true") {
      debugImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:2.12'
  }
  

推荐组合方案 #

结合方案1和方案2：

• 本地开发时，无压缩+自动适配高版本多Dex，保持性能；
• CI构建时，自动启用轻量压缩+Multidex兜底，解决64K限制；
• pre-5.0设备调试时，Multidex自动生效，无需额外操作。

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