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

React Native Android项目运行时Gradle下载终止及许可证问题求助

嘿,刚入门React Native就碰到这些构建问题很正常,我来一步步帮你搞定:

解决React Native Android构建的三类问题

1. 修复「无法加载repositories.cfg」的警告

这个文件缺失只是个小警告,不会影响核心构建,直接创建它就行:

  • 打开文件资源管理器,找到路径 C:\Users\hasee\.android
  • 新建一个空白文本文件,重命名为 repositories.cfg(注意要去掉默认的.txt后缀)
  • 保存后关闭,下次构建就不会再弹这个提示了

2. 处理Android SDK Build-Tools 23.0.1的许可证问题

许可证未接受是构建失败的常见原因,你需要手动确认接受:

  • 找到你的Android SDK目录下的tools\bin文件夹,路径是 C:\Users\hasee\AppData\Local\Android\Sdk\tools\bin
  • 打开CMD,导航到这个路径,运行命令:
    sdkmanager --licenses
    
  • 按照终端提示输入y,接受所有需要的许可证(包括Build-Tools 23.0.1的)

3. 解决Gradle下载终止的问题

Gradle下载失败大多是网络或镜像的问题,试试这几个方案:

  • 方案一:手动下载Gradle包
    先查看项目需要的Gradle版本:打开android\gradle\wrapper\gradle-wrapper.properties文件,找到distributionUrl字段(比如https\://services.gradle.org/distributions/gradle-7.5-all.zip)
    手动下载对应的压缩包,放到C:\Users\hasee\.gradle\wrapper\dists\gradle-xxx-all\随机字符串目录下(没有的话就自己创建),解压后重新运行构建命令
  • 方案二:配置国内镜像加速
    打开项目的android\build.gradle文件,把默认仓库替换成国内镜像(比如阿里云),修改后的代码如下:
    buildscript {
        repositories {
            maven { url 'https://maven.aliyun.com/repository/google' }
            maven { url 'https://maven.aliyun.com/repository/jcenter' }
            maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
        }
        dependencies {
            classpath("com.android.tools.build:gradle:7.3.1")
            classpath("com.facebook.react:react-native-gradle-plugin")
        }
    }
    
    allprojects {
        repositories {
            maven { url 'https://maven.aliyun.com/repository/google' }
            maven { url 'https://maven.aliyun.com/repository/jcenter' }
            maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
            maven { url "$rootDir/../node_modules/react-native/android" }
            maven { url "$rootDir/../node_modules/jsc-android/dist" }
        }
    }
    
  • 方案三:检查网络代理
    如果开启了代理,可能会阻断Gradle的下载请求,尝试关闭代理;如果需要代理,就在项目的gradle.properties文件里添加代理配置(比如systemProp.http.proxyHost=xxx和systemProp.http.proxyPort=xxx)

完成以上步骤后,重新运行 npx react-native run-android,应该就能顺利构建并运行你的React Native Android应用了。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.25 07:37:47