解决AndroidStudio中运行`npx react-native run-android`时的`Task :app:checkDebugAarMetadata FAILED`错误

2024-03-26 09:09:15

解决 Android Studio 中运行 npx react-native run-android 时出现的 Task :app:checkDebugAarMetadata FAILED 错误

简介

在使用 npx react-native run-android 命令运行 Android 应用程序时，可能会遇到令人头疼的 Task :app:checkDebugAarMetadata FAILED 错误。此错误表明在检查应用程序的 Android 存档 (AAR) 元数据时出现问题，导致应用程序无法构建。本文将深入探讨此错误的潜在原因，并提供一系列经过验证的解决方案，帮助你快速解决此问题。

错误分析

AAR 元数据：
AAR 是一个包含应用程序编译代码的压缩文件，其中包括本机库和资源。当构建应用程序时，Gradle 将检查 AAR 元数据以确保所有依赖项都可用且兼容。如果发现任何不兼容或缺失，就会引发 Task :app:checkDebugAarMetadata FAILED 错误。

潜在原因

过时的 Android SDK：
确保已安装最新的 Android SDK。过时的 SDK 可能不兼容较新的 Gradle 版本，导致元数据检查失败。
不兼容的 Gradle 版本：
Gradle 7.0 及更高版本可能与旧版本的 Android Gradle 插件不兼容。将 Gradle 版本更新至至少 6.7 版，但低于 7.0 版。
第三方库冲突：
应用程序中使用的第三方库可能会与 AAR 元数据中的其他依赖项冲突。检查第三方库的兼容性，并尝试升级或降级相关版本。
JNI 库冲突：
如果应用程序中有多个库包含具有相同 OS 独立路径的 JNI 库（例如 libfbjni.so），也会引发此错误。

解决方案

1. 更新 Android SDK 和 Gradle：

确保已安装最新的 Android SDK。
将 Gradle 版本更新至至少 6.7 版，但低于 7.0 版。

2. 检查第三方库：

检查应用程序中使用的第三方库，确保它们与 Android SDK 和 Gradle 版本兼容。
如果发现任何冲突，尝试升级或降级相关的库版本。

3. 解决 JNI 库冲突：

确定具有相同 OS 独立路径的 JNI 库。
在构建脚本中，使用 exclude 配置来排除冲突库中的 JNI 库。

android {
    ...
    externalNativeBuild {
        cmake {
            path "CMakeLists.txt"
            arguments "-DANDROID_STL=c++_static"
            abiFilters "x86", "x86_64", "armeabi-v7a", "arm64-v8a"
            targets "libfoo", "libfoo_static"
            // 排除冲突库
            exclude "armeabi-v7a/libfbjni.so"
        }
    }
}