Mac环境下React Native Android构建失败：react-native-vector-icons Gradle属性弃用问题

我之前在Mac上折腾React Native Android项目时，也碰到过几乎一模一样的问题——Windows上跑的好好的，Mac上就卡在react-native-vector-icons的Gradle配置上。给你几个亲测有效的解决步骤：

1. 修复react-native-vector-icons的Gradle过时配置 #

这个警告（CompileOptions.bootClasspath已废弃）看起来只是警告，但往往是触发构建失败的导火索：

• 打开项目里的 node_modules/react-native-vector-icons/android/build.gradle 文件
• 搜索关键词 bootClasspath，把所有出现的 CompileOptions.bootClasspath 替换成 CompileOptions.bootstrapClasspath
• 保存文件后，进入android目录清理构建缓存：

  cd android && ./gradlew clean
  cd ..
  

2. 检查Mac上的Android环境配置 #

Mac的Android环境经常会有路径或版本匹配的问题，确认以下几点：

• 验证ANDROID_HOME环境变量是否正确配置，终端输入：

  echo $ANDROID_HOME
  

  正常应该输出类似 ~/Library/Android/sdk 的路径，如果为空，需要在~/.bash_profile或~/.zshrc里添加配置（根据你用的shell）：

  export ANDROID_HOME=~/Library/Android/sdk
  export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools
  

• 确认Android模拟器已经正常启动，或者真机已通过USB连接（用adb devices可以查看已连接的设备）
• 检查项目的Gradle版本是否和React Native兼容：打开android/gradle/wrapper/gradle-wrapper.properties，确保distributionUrl指向的Gradle版本和你当前RN版本匹配（比如RN 0.65+建议用Gradle 7.x）

3. 重新安装依赖并构建 #

有时候依赖缓存也会出问题，按以下步骤重置：

• 删除旧的依赖和锁文件：

  rm -rf node_modules package-lock.json yarn.lock
  

• 重新安装依赖：

  npm install  # 或者 yarn install，看你用的包管理器
  

• 最后再次尝试运行：

  react-native run-android
  

如果还是不行，可以试试手动链接react-native-vector-icons（虽然新版本RN支持自动链接，但Mac上偶尔会失效）：

react-native link react-native-vector-icons

链接完成后记得再执行一次./gradlew clean，然后重新构建。

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