解决 React Native 'Execution failed for task ':app:mergeDexDebug'' 错误的终极指南

React Native "Execution failed for task ':app:mergeDexDebug'" 错误的终极解决方案

简介

在尝试在真机设备上运行 React Native 应用时，开发人员可能会遇到一个常见的错误："Execution failed for task ':app:mergeDexDebug'"。此错误表明应用的 DEX（Dalvik 可执行文件）文件中方法引用数量超过了 64K 的限制。

成因分析

DEX 文件是用于在 Android 设备上运行 Java 代码的文件格式。当 DEX 文件包含过多的方法引用时，就会出现上述错误。这通常是由以下原因造成的：

• 过多的依赖项
• 未使用或冗余的代码
• 没有使用 ProGuard 混淆

解决方案

解决此错误的几种有效方法包括：

1. 启用多 DEX

通过在 app 的 gradle.properties 文件中添加以下行来启用多 DEX：

multiDexEnabled true

2. 使用 ProGuard 混淆

ProGuard 是一种 Java 代码混淆工具，它可以移除未使用的代码和方法引用，从而减小应用的大小和 DEX 文件的大小。要在项目中启用 ProGuard，请在 app 的 build.gradle 文件中添加以下部分：

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

3. 删除未使用的依赖项

仔细检查应用的依赖项，并删除任何不使用的依赖项。不必要的依赖项会增加应用的大小并导致 DEX 文件过大。

4. 使用 Android Gradle 插件 7.0 或更高版本

Android Gradle 插件 7.0 引入了 DEX 多dex 处理，可自动处理多 DEX 问题。

步骤指南

1. 确定问题的原因（方法引用过多）。
2. 选择一个解决方案（启用多 DEX、使用 ProGuard 或删除未使用的依赖项）。
3. 根据所选解决方案实施更改。
4. 重新构建应用。

代码示例

启用多 DEX

multiDexEnabled true

使用 ProGuard 混淆

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

结论

通过遵循这些解决方案，可以轻松解决 "Execution failed for task ':app:mergeDexDebug'" 错误，并成功在真机设备上运行 React Native 应用。

常见问题解答

1. 什么是 DEX 文件？

DEX 文件是一种用于在 Android 设备上运行 Java 代码的文件格式。

2. 为什么会出现 "Execution failed for task ':app:mergeDexDebug'" 错误？

此错误表明应用的 DEX 文件中方法引用数量超过了 64K 的限制。

3. 如何解决 "Execution failed for task ':app:mergeDexDebug'" 错误？

可以通过启用多 DEX、使用 ProGuard 混淆或删除未使用的依赖项来解决此错误。

4. 什么是 ProGuard？

ProGuard 是一种 Java 代码混淆工具，它可以移除未使用的代码和方法引用，从而减小应用的大小和 DEX 文件的大小。

5. 如何启用 ProGuard？

要在 React Native 项目中启用 ProGuard，请在 app 的 build.gradle 文件中添加以下部分：

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