安装react-native-maps后裸React Native应用构建失败求助

核心错误分析 #

1. AndroidManifest 废弃警告 #

在源文件AndroidManifest.xml（路径：C:\Users\Dell\ow\node_modules\react-native-maps\android\src\main\AndroidManifest.xml）中发现package="com.rnmaps.maps"。通过源AndroidManifest.xml的package属性设置命名空间已不再被支持，该值将被忽略，建议移除该文件中的package="com.rnmaps.maps"。

2. JDK 与 Gradle 兼容错误 #

Task :react-native-maps:compileDebugJavaWithJavac FAILED
构建失败核心异常：执行任务':react-native-maps:compileDebugJavaWithJavac'失败，无法解析配置':react-native-maps:androidJdkImage'的所有文件，转换core-for-system-modules.jar匹配属性时出错，调用C:\Program Files\Java\jdk-21\bin\jlink.exe执行JdkImageTransform时出现错误。

解决步骤 #

处理 AndroidManifest 废弃问题 #

• 找到node_modules/react-native-maps/android/src/main/AndroidManifest.xml文件，删除其中的package="com.rnmaps.maps"属性
• 为避免后续依赖安装覆盖修改，使用patch-package持久化补丁：
  1. 安装依赖：npm install patch-package --save-dev
  2. 生成补丁：npx patch-package react-native-maps
  3. 将项目根目录下生成的patches文件夹提交到版本控制

修复 JDK 与 Gradle 兼容问题 #

react-native-maps 目前版本对 JDK 21 支持不佳，建议降级到 React Native 官方推荐的 JDK 17：

• 卸载 JDK 21，安装 OpenJDK 17（如 Adoptium 提供的版本）
• 更新系统环境变量JAVA_HOME指向 JDK 17 的安装路径
• 清理项目构建缓存：
  • 进入 android 目录执行：gradlew clean
  • 回到项目根目录执行：npm cache clean --force
• 重新构建项目：npx react-native run-android

可选：调整 Gradle 版本 #

若项目使用 Gradle 9.x，可尝试降级到 Gradle 8.x（确保与 JDK 17 兼容）：

• 修改android/gradle/wrapper/gradle-wrapper.properties中的distributionUrl，替换为 Gradle 8.x 的下载链接，例如：

  distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-all.zip
  

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