macOS Big Sur 上 React Native 无法找到 tools.jar 的终极修复指南

在 macOS Big Sur 上无法找到 tools.jar 的修复指南

问题背景

在升级到 macOS Big Sur 后，许多 React Native 开发人员在运行 npx react-native run-android 命令时遇到了一个恼人的错误：

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':react-native-linear-gradient:compileDebugJavaWithJavac'.
> Could not find tools.jar. Please check that /Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home contains a valid JDK installation.

追溯根源

该错误的根源在于 tools.jar 文件在 macOS Big Sur 中的位置发生了变化。这个文件是 Java 开发工具包 (JDK) 的一个关键组件，在编译 Android 应用程序时需要它。

解决方案

要解决此问题，你可以采取以下步骤：

1. 检查 JDK 安装

确保你的 Mac 上安装了 Java JDK。运行以下命令来验证：

/usr/libexec/java_home -v

如果没有安装 JDK，请从 Oracle 网站下载并安装。

2. 设置 JAVA_HOME

安装 JDK 后，设置 JAVA_HOME 环境变量，使其指向 JDK 安装目录：

export JAVA_HOME=`/usr/libexec/java_home`

3. 更新 React Native 依赖项

更新 React Native 的依赖项：

npx react-native upgrade

4. 清理构建

删除 node_modules 目录以及 ios/build 和 android/build 目录。然后重新运行 npx react-native run-android 命令。

常见问题解答

• 我已经安装了 JDK，但问题仍然存在怎么办？

  • 尝试重新安装 React Native：npx react-native init AwesomeProject --version react-native@latest

• 如何验证 JAVA_HOME 是否设置正确？

  • 运行 echo $JAVA_HOME 命令，它应该输出 JDK 安装目录。

• 为什么 React Native 无法自动找到 tools.jar？

  • React Native 依赖系统环境变量来查找 JDK。如果没有正确设置，它将无法找到 tools.jar。

结论

按照本文的步骤操作，你应该能够解决在 macOS Big Sur 上运行 React Native 应用程序时遇到的 "无法找到 tools.jar" 错误。如果问题仍然存在，请寻求专业技术支持。