执行yarn android时React Native Android构建失败求助

问题背景 #

环境：Windows 10、React 18.2.0、React Native 0.71.3、Android Gradle插件7.3.1、Gradle 7.5.1
执行yarn android启动项目时构建失败，核心错误：

• 配置:react-native-reanimated时找不到AAR包，触发源码构建
• Task :app:processDebugResources任务失败，提示resource mipmap/ic_launcher_round not found，伴随java.lang.StackOverflowError

一、修复mipmap/ic_launcher_round资源缺失 #

• 检查android/app/src/main/res目录，确认所有mipmap-xxx文件夹下都有ic_launcher_round.png（对应不同分辨率）
  • 缺失的话直接从Mac端项目的对应目录复制资源到Windows项目
  • 也可以重新生成图标：执行npx react-native set-icon --path path/to/your/icon.png（确保图标适配圆形规格）
• 打开AndroidManifest.xml，检查application标签的android:roundIcon属性，要么确保指向存在的资源，要么直接删除该属性（不需要圆形图标时）

二、解决react-native-reanimated AAR包找不到的问题 #

1. 清理缓存

   cd android
   ./gradlew clean
   rm -rf .gradle/caches
   cd ..
   yarn cache clean
   

2. 检查仓库配置
   打开android/build.gradle，确保buildscript和allprojects的repositories包含以下内容：

   buildscript {
       repositories {
           google()
           mavenCentral()
       }
       // 其他配置不变
   }
   
   allprojects {
       repositories {
           mavenCentral()
           google()
           maven { url "$rootDir/../node_modules/react-native/android" }
           maven { url "$rootDir/../node_modules/jsc-android/dist" }
       }
   }
   

3. 匹配兼容版本
   在package.json中指定与RN0.71.3兼容的reanimated版本（推荐2.14.4），重新安装依赖：

   yarn add react-native-reanimated@2.14.4
   cd android && ./gradlew sync
   

4. 关闭源码构建
   打开android/settings.gradle，确保reanimated的配置为：

   include ':react-native-reanimated'
   project(':react-native-reanimated').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-reanimated/android')
   

三、解决java.lang.StackOverflowError #

• 调整Gradle堆内存：在android/gradle.properties中添加或修改：

  org.gradle.jvmargs=-Xmx4096m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
  

• 确认JDK版本为11（RN0.71.x强制要求），执行java -version检查，版本不符则切换到JDK11
• 删除android/app/build和android/build目录，重新执行yarn android

内容的提问来源于stack exchange，提问作者sysdevs