准备工作与环境要求

在开始安装Android SDK之前，请确保您的计算机满足以下基本要求。

系统与硬件要求

首先，需要一个稳定的操作系统，如Windows、macOS或Linux。

其次，确保计算机有足够的磁盘空间。SDK及其组件，尤其是不同版本的系统镜像和构建工具，会占用较大空间。

最后，稳定的网络连接必不可少，因为大部分安装过程需要在线下载工具包和平台文件。

安装Java开发工具包（JDK）

您需要预先安装Java开发工具包（JDK）。

Android Studio通常捆绑了所需JDK。但如果您计划使用命令行工具或进行更底层开发，则需要独立安装并配置JAVA_HOME环境变量。

请访问Oracle官网或OpenJDK项目网站，下载与您系统匹配的JDK版本并进行安装。

获取Android SDK工具包

获取Android SDK主要有两种途径。

方式一：通过Android Studio安装（推荐）

这是最主流和推荐的方式。Android Studio是一个完整的IDE，安装过程会自动包含最新的Android SDK命令行工具，并提供图形化的SDK管理器。

您只需访问Android开发者官网，下载对应操作系统的安装包，按照向导步骤执行即可。

方式二：独立安装命令行工具

这种方式适合偏好轻量级环境、使用其他编辑器或进行自动化构建的开发者。

您可以下载仅包含命令行工具的SDK压缩包。解压到指定目录后，其下的“tools”或“cmdline-tools”文件夹就包含了核心的SDK管理器（sdkmanager）等基础工具。

这种方式需要您后续通过命令行来管理和下载其他SDK组件。

使用SDK管理器安装组件

获取基础工具后，下一步是使用SDK管理器安装具体的开发平台和工具。

在Android Studio中安装

通过菜单找到“Settings”或“Preferences” -> “Appearance & Behavior” -> “System Settings” -> “Android SDK”。

在图形化列表中，您可以看到所有可用组件：

• SDK平台版本（如Android 14, 13）
• 系统镜像
• 构建工具（Build-Tools）
• 平台工具（Platform-Tools）
• 扩展库

必须勾选您目标平台版本的“SDK Platform”。

建议同时安装该版本的“Sources for Android SDK”以及一个对应的“System Image”。此外，“Android SDK Build-Tools”和“Android SDK Platform-Tools”也应保持最新或与目标平台匹配。

选择完毕后，点击“Apply”或“OK”开始下载安装。

使用命令行安装

对于使用独立命令行工具的用户，需要打开终端，导航到SDK的“cmdline-tools/bin”目录。

主要命令如下：

• 使用 sdkmanager --list 查看所有可用包。
• 使用 sdkmanager “platforms;android-34” “build-tools;34.0.0” 安装指定平台和构建工具。

命令行方式提供了更高的灵活性和脚本化能力。

配置系统环境变量

为了方便地在任何命令行窗口中使用Android SDK工具，需要配置系统环境变量。

主要需配置两个路径：

1. Android SDK的根目录路径。
2. “platform-tools”和“tools”（或“cmdline-tools/bin”）子目录的路径。

Windows系统配置

1. 在“系统属性”的“高级”选项卡下，点击“环境变量”。

2. 在“系统变量”部分，新建一个名为 ANDROID_HOME 的变量，值为您的Android SDK根目录完整路径（例如：C:UsersYourNameAppDataLocalAndroidSdk）。

3. 编辑“Path”变量，在末尾追加：

• %ANDROID_HOME%platform-tools
• %ANDROID_HOME%tools（或%ANDROID_HOME%cmdline-toolslatestbin）

macOS或Linux系统配置

1. 编辑用户主目录下的shell配置文件（如.bash_profile、.zshrc）。

2. 添加以下行：

• export ANDROID_HOME=/Users/YourName/Library/Android/sdk
• export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools

3. 保存文件后，在终端执行 source ~/.zshrc（根据您使用的配置文件）使配置生效。

验证安装与创建项目

完成所有安装和配置后，请进行验证。

验证安装

打开一个新的命令行终端，输入以下命令：

• 输入 adb version。如果显示Android Debug Bridge（ADB）版本信息，则表明“platform-tools”路径配置正确。
• 输入 sdkmanager --version 来检查SDK管理器工具是否可用。

创建测试项目

在Android Studio中，点击“New Project”，选择一个模板（如“Empty Views Activity”）。

按照向导设置项目名称、包名、保存位置及目标Android版本（请确保该版本已在SDK管理器中安装）。

点击“Finish”，Android Studio会自动使用Gradle构建项目。如果项目能成功构建并运行在设备或模拟器上，则证明您的Android SDK环境已配置成功。

对于不使用Android Studio的用户，可以使用命令行工具配合Gradle进行构建。

无论采用何种工作流，正确安装和配置的Android SDK都是所有Android应用开发的基石。请保持SDK组件，尤其是构建工具和平台工具的定期更新，以获取最新功能优化和安全补丁。