无法在单个 dex 文件中容纳请求的类 - Java

在 Android 应用程序中，为了方便代码维护和优化应用性能，通常将 Java 类编译成 dex 格式的文件以在设备上运行。然而，如果您的应用程序中引用的类太多，可能会遇到 “无法在单个 dex 文件中容纳请求的类” 错误。

这种错误通常会在 Gradle 构建过程中出现，并且会抛出 com.android.dex.DexIndexOverflowException 异常。那么如何解决这个问题呢？

解决方法

1. 启用 multidex 支持

一种解决方法是启用 multidex 支持。Multidex 可以在应用程序中启用多个 dex 文件执行类加载相关操作。以下是实现此方法的步骤：

首先，在 app/build.gradle 文件中添加 multidex 依赖：

dependencies {
   implementation 'com.android.support:multidex:1.0.3'
}

接下来，在应用程序类中覆盖 Application 类并启用 multidex 支持：

import android.app.Application;
import android.content.Context;
import androidx.multidex.MultiDex;

public class MyApplication extends Application {

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

最后，在 Manifest 文件中将应用程序的名称更改为自定义的应用程序类名称：

<application
    android:name=".MyApplication"
    ...>
    ...
</application>

2. 移除未使用的类

另一种解决方法是移除未使用的类。在代码编写过程中，我们可能引用了一些不必要的方法或类，这些方法或类在构建过程中也会被包含在 dex 文件中。可以使用 ProGuard 工具来优化应用程序，并移除未使用的类和方法。

3. 拆分依赖库

如果您的应用程序引用了许多第三方库，可以尝试拆分这些库。在 Gradle 文件中，您可以指定将某些库放入 com.android.library 模块中。在应用程序中使用这些库时，Gradle 将在生成 dex 文件时为每个库生成单独的 dex 文件。这样，如果您的应用程序引用了太多的库，您就可以缓解这个问题。

android {
  ...
  splits {
    // Enables building multiple APKs for ABI splits.
    abi {
      // Enables ABI split implementation.
      enable true
      // By default all ABIs are included, so use reset() and include to specify that we only
      // want APKs for x86 and x86_64.
      reset()
      // Specifies a list of ABIs that Gradle should create APKs for.
      include "x86", "x86_64"
      // Specifies that we do not want to also generate a universal APK that includes all ABIs.
      universalApk false
    }
  }
  ...
}

结论

在这篇文章中，我们了解了 “无法在单个 dex 文件中容纳请求的类” 错误，并提供了解决此错误的三种常见方法。无论您选择哪种方法，目标都是缓解 dex 文件大小的限制，以确保您的应用程序在 Android 设备上完美地运行。