androidsdk目录更改指南

Android SDK 目录更改指南

在 Android 开发过程中，有时我们需要更改 Android SDK 的目录。比如，原磁盘空间不足，想将 SDK 转移到有更多空间的磁盘；或者因项目需求，要使用特定版本 SDK 并安装在指定目录等。下面为你详细介绍更改 Android SDK 目录的方法。

一、在 Android Studio 中更改

方法一：通过项目结构设置

1. 打开项目结构窗口：打开 Android Studio 项目，依次点击菜单栏中的File -> Project Structure 。也可使用快捷键，Windows 和 Linux 系统下是Ctrl + Alt + Shift + S，Mac 系统下是Command + ; 。

1. 找到 SDK 位置设置：在弹出的Project Structure窗口中，选择左侧列表中的SDK Location选项 。

1. 更改 SDK 路径：在右侧的Android SDK location文本框中，直接输入新的 Android SDK 目录路径，或点击文本框右侧的文件夹图标，通过文件浏览器选择新的目录。

1. 应用更改：完成路径修改后，点击OK按钮保存更改。Android Studio 会自动更新项目配置，若新路径下没有所需的 SDK 组件，可能会提示下载。

方法二：通过系统设置更改

1. 打开设置窗口：点击File -> Settings（Windows/Linux）或Android Studio -> Preferences（Mac） 。

1. 找到 SDK 设置：在设置窗口中，展开Appearance & Behavior -> System Settings ，然后选择Android SDK 。

1. 修改 SDK 路径：在Android SDK Location处，按照上述同样的方式，输入新路径或通过文件夹图标选择新目录。

1. 保存设置：点击Apply或OK保存更改。之后，Android Studio 会基于新的 SDK 路径进行操作，比如同步项目时会从新路径获取 SDK 相关信息。

方法三：在项目关闭状态下更改

1. 关闭当前项目：点击File -> Close Project 。

1. 进入项目默认设置：在欢迎界面右下角，点击Configure ，选择Project Defaults -> Project Structure 。

1. 设置 SDK 路径：在弹出的Project Structure窗口的SDK Location中，修改Android SDK location为新路径。

1. 应用更改：点击OK，后续新建或打开项目时，Android Studio 将使用新设置的 SDK 路径。

二、通过环境变量更改

对于 Windows 系统

1. 打开系统属性：右键点击 “此电脑”，选择 “属性”，在弹出窗口中点击 “高级系统设置” 。

1. 打开环境变量设置：在 “系统属性” 窗口的 “高级” 选项卡下，点击 “环境变量” 按钮 。

1. 编辑或添加 ANDROID_HOME 变量

• • 若已存在：在 “系统变量” 列表中找到ANDROID_HOME变量，选中它并点击 “编辑” ，将 “变量值” 修改为新的 Android SDK 目录路径 。

• • 若不存在：点击 “新建” ，在 “变量名” 处输入ANDROID_HOME ，“变量值” 处填写新路径 。

1. 更新 Path 变量：确保 “系统变量” 中的Path变量包含%ANDROID_HOME%\platform-tools和%ANDROID_HOME%\tools（若使用旧版 SDK）。若没有，点击 “编辑” ，在弹出窗口中点击 “新建” ，分别添加这两个路径。

1. 保存更改：依次点击 “确定” 关闭所有窗口。之后在命令行或相关开发工具中，系统将依据新环境变量识别 Android SDK 路径。

对于 macOS 和 Linux 系统

1. 打开终端：Mac 系统可通过Command + Space调出聚焦搜索，输入 “Terminal” 打开终端；Linux 系统一般使用Ctrl + Alt + T快捷键打开终端 。

1. 编辑环境变量配置文件：常用的环境变量配置文件有~/.bashrc、~/.bash_profile或~/.zshrc 。可使用vim或nano等文本编辑器进行编辑。例如，使用nano编辑~/.zshrc文件，在终端输入nano ~/.zshrc 。

1. 添加或修改 ANDROID_HOME 变量：在打开的文件中，添加或修改以下行，将路径替换为新的 Android SDK 目录：

export ANDROID_HOME=/path/to/your/android/sdk

export PATH=$PATH:$ANDROID_HOME/platform-tools

export PATH=$PATH:$ANDROID_HOME/tools

1. 保存并退出文件：在nano中，按下Ctrl + X ，按Y确认保存，再按Enter键退出 。

1. 使配置生效：在终端执行source ~/.zshrc（若编辑的是其他文件，对应修改命令），使新的环境变量配置立即生效。

三、修改项目中的 local.properties 文件

在项目根目录下，有一个local.properties文件，该文件可指定项目使用的 SDK 路径。使用文本编辑器打开此文件，找到sdk.dir属性，将其值修改为新的 Android SDK 目录路径，如：

sdk.dir=/path/to/your/android/sdk

保存文件后，项目构建过程中 Gradle 会读取该文件，使用新指定的 SDK 路径。但通常不建议直接修改此文件，优先通过上述 Android Studio 的设置方式更改 SDK 路径，以免出现配置不一致问题。

更改 Android SDK 目录后，建议同步项目（在 Android Studio 中点击File -> Sync Project with Gradle Files） ，确保项目能正确识别新的 SDK 路径及相关组件，避免因路径问题导致构建或运行错误。