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

运行React Native应用报Gradle及mipmap资源缺失错误如何解决

React Native安卓构建失败排查解决步骤

核心错误修复(构建失败直接原因)

本次构建失败的根因是安卓打包时找不到应用图标资源,按以下步骤排查:

  • 检查图标资源是否存在
    进入项目android/app/src/main/res/目录,查看所有以mipmap-开头的文件夹(如mipmap-mdpi、mipmap-hdpi、mipmap-xhdpi等),确认是否存在名为storyqube的图标文件(支持png、webp格式)。注意安卓资源文件名只能用小写字母、数字和下划线,大写字母、特殊字符都会导致识别失败。
  • 核对清单文件引用配置
    打开报错指定的android/app/src/main/AndroidManifest.xml文件,定位到第13行附近的android:icon属性,确认属性值为@mipmap/storyqube,和实际的图标文件名完全一致。如果暂时没有对应图标,可先修改为默认值@mipmap/ic_launcher先跑通构建。
  • 清理缓存后重新构建
    如果是刚替换过图标出现的报错,依次执行以下命令清理缓存后重试:
    1. 进入安卓项目目录:cd android
    2. 清理Gradle构建缓存:Windows系统执行gradlew.bat clean,Mac/Linux系统执行./gradlew clean
    3. 返回项目根目录清理RN缓存:cd .. && npx react-native start --reset-cache
    4. 重新触发构建:npx react-native run-android

附带警告优化(非构建失败原因,可避免后续兼容问题)

  • 修复compile配置过时警告:打开android/app/build.gradle和android/build.gradle文件,将所有依赖声明中的compile关键字替换为implementation即可。
  • 修复Build Tools版本过低警告:打开android/app/build.gradle文件,找到buildToolsVersion '23.0.1'这一行直接删除即可,新版Android Gradle插件会自动适配兼容的构建工具版本,无需手动指定。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.02 23:45:03