React Native Android 构建报错“SDK location not found”：终极解决指南

2024-03-30 14:16:43

Android Studio 中 React Native Android 构建失败：修复 "SDK location not found" 错误

概述

在 Android Studio 中构建 React Native Android 项目时，开发人员可能会遇到 "SDK location not found" 错误。此错误表明 Android SDK 的位置尚未正确配置，导致构建过程无法找到必要的资源。本文将深入探讨导致此错误的潜在原因，并提供逐步解决方案，帮助您解决问题并成功构建您的 Android 项目。

诊断错误

当构建 React Native Android 项目时，如果出现 "SDK location not found" 错误，表示 Android Studio 无法找到 SDK 的位置。可能是以下原因导致此错误：

缺失的 local.properties 文件 ：local.properties 文件包含有关 Android SDK 位置的信息，如果此文件不存在或未正确配置，则可能会导致此错误。
未设置 ANDROID_HOME 环境变量 ：ANDROID_HOME 环境变量也用于指定 Android SDK 的位置，如果未设置或设置不正确，则可能会导致此错误。
SDK 组件安装不完整 ：在构建 React Native Android 项目时，需要安装特定的 SDK 组件。如果缺少这些组件，则可能会导致此错误。

解决方案

解决 "SDK location not found" 错误的步骤如下：

检查 local.properties 文件 ：确保 project 根目录下存在 local.properties 文件。如果不存在，请创建它并添加以下行：sdk.dir=/path/to/your/android/sdk，将 /path/to/your/android/sdk 替换为 Android SDK 的实际安装路径。
设置 ANDROID_HOME 环境变量 ：如果 local.properties 文件无法解决问题，请设置 ANDROID_HOME 环境变量。在 Windows 中，请转到控制面板 > 系统和安全 > 系统 > 高级系统设置 > 环境变量。在 Mac 中，请在终端中运行 export ANDROID_HOME=/path/to/your/android/sdk。
更新 Android Studio ：确保使用最新版本的 Android Studio。旧版本可能存在错误，导致此类问题。
清除缓存 ：有时，清除 Android Studio 缓存可以解决此问题。转到文件 > 无效缓存/重新启动。
检查 SDK 组件 ：确保已安装必要的 SDK 组件。转到工具 > Android > SDK 管理器，并安装 Android SDK Platform、Android SDK Build-Tools 和 Android Emulator。
重新启动 Android Studio ：在进行任何更改后，请重新启动 Android Studio。这将使新设置生效。
重新构建项目 ：尝试重新构建项目。转到构建 > 重新构建项目。