React Native应用无法安装至设备的问题解决请求
解决React Native中Gradle下载失败(UnknownHostException)的问题
从你的报错信息和环境来看,核心问题是网络无法连接到services.gradle.org,导致Gradle 2.14.1安装包下载失败,进而无法在模拟器上安装App。下面是几个针对性的解决办法:
1. 排查网络与代理设置
- 先验证网络连通性:打开浏览器访问
https://services.gradle.org/distributions/gradle-2.14.1-all.zip,如果无法打开,说明你的网络无法访问该域名,可能是网络限制、代理或防火墙导致的。 - 如果你使用了代理,需要给Gradle配置代理:
- 找到项目根目录下的
android/gradle.properties文件(如果没有就新建),添加以下内容(替换成你的代理信息):systemProp.http.proxyHost=你的代理IP systemProp.http.proxyPort=代理端口 systemProp.https.proxyHost=你的代理IP systemProp.https.proxyPort=代理端口 - 也可以配置全局Gradle代理:在Windows用户目录(
C:\Users\<你的用户名>)下找到.gradle文件夹,里面新建gradle.properties文件并添加上述代理配置。
- 找到项目根目录下的
- 临时关闭防火墙或杀毒软件,确认是否是它们拦截了Gradle的网络请求。
2. 手动下载Gradle包并配置缓存
如果网络问题暂时无法解决,手动下载是最直接的办法:
- 去Gradle官方镜像下载
gradle-2.14.1-all.zip(确保文件名和版本完全一致)。 - 找到本地Gradle缓存目录:Windows下路径通常是
C:\Users\<你的用户名>\.gradle\wrapper\dists\gradle-2.14.1-all\,里面会有一个随机字符命名的文件夹(比如8bnwg5hd3w55iofp58khbp6yv)。 - 把下载好的
gradle-2.14.1-all.zip放到这个随机字符文件夹里,不需要解压。 - 回到项目根目录,重新运行
react-native run-android。
3. 调整Gradle配置(可选)
如果上述方法无效,你可以尝试修改项目的Gradle配置:
- 打开项目
android/gradle/wrapper/gradle-wrapper.properties文件,把distributionUrl的值改成你本地下载的zip文件路径,比如:
注意Windows路径要转义,用distributionUrl=file\:///C\:/Users/xxx/Downloads/gradle-2.14.1-all.zip\分隔或者用正斜杠。 - 也可以尝试升级Gradle版本(兼容你的React Native 0.55.4):打开
android/build.gradle,把dependencies里的classpath 'com.android.tools.build:gradle:2.2.3'(对应Gradle 2.14.1)升级到classpath 'com.android.tools.build:gradle:2.3.3',同时修改gradle-wrapper.properties里的distributionUrl为https\://services.gradle.org/distributions/gradle-3.3-all.zip,再重新构建。
4. 清理缓存后重新构建
运行以下命令清理项目缓存,再尝试构建:
cd android gradlew clean cd .. react-native run-android
内容的提问来源于stack exchange,提问作者Vivek
相关产品推荐
相关产品推荐

