You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Gradle升级后React Native项目Android Studio报错求助

解决Gradle升级后React Native项目的Android构建报错

问题本质

Gradle 7.x+ 彻底移除了compile配置,且implementation是仅用于声明依赖、不可直接解析的配置(canBeResolved=false)。你的报错源于项目中存在直接引用compile配置的代码,或在自定义任务里错误地直接解析implementation配置。

修复步骤

1. 替换所有废弃的compile依赖声明

遍历项目中所有build.gradle文件,把依赖声明里的compile全部替换为implementation或api:

// 错误写法
compile 'com.example:xxx:1.0.0'

// 正确写法(仅当前模块使用依赖)
implementation 'com.example:xxx:1.0.0'
// 若需让依赖传递给上层模块,用api
api 'com.example:xxx:1.0.0'

2. 修复自定义任务中的配置引用

如果项目有自定义Gradle任务(比如复制依赖、打包类库的任务)直接引用了implementation,必须替换为可解析的配置:

  • 编译时依赖用compileClasspath
  • 运行时依赖用runtimeClasspath

示例修正:

// 错误代码
task copyLibs(type: Copy) {
    from configurations.implementation
    into './libs'
}

// 修正后代码
task copyLibs(type: Copy) {
    from configurations.compileClasspath // 按需切换为runtimeClasspath
    into './libs'
}

3. 适配React Native与Gradle版本兼容性

你当前使用的com.android.tools.build:gradle:7.2.1需要React Native 0.68.x及以上版本适配。如果你的RN版本低于0.68,二选一:

  • 升级React Native到0.68.x+版本,或
  • 降低Gradle插件版本到项目兼容范围(比如RN 0.67对应Gradle 7.0.x)

4. 清理缓存并重新构建

完成修改后执行以下命令,确保缓存清理干净:

# 清理Gradle构建缓存
./gradlew clean

# 重新安装Node依赖(可选,确保RN依赖完整)
npm install

# 启动Android项目
npx react-native run-android

验证

执行npx react-native run-android后,若构建成功即可正常启动安卓模拟器运行项目。若仍有报错,检查是否遗漏了compile引用,或自定义任务中还有未修正的配置引用。

内容的提问来源于stack exchange,提问作者Nass

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.31 01:24:26