Android SDK 安装指南（MacOS 和 Windows）

Android SDK 安装指南（MacOS 和 Windows）

你需要在对应开发环境（Windows 或 macOS 13.2.1）上安装 Android SDK ，核心需求是完成环境配置、适配跨平台/App开发、后续能正常编译Android项目 。Android SDK 有两种安装方式：「通过Android Studio自动安装（推荐，新手友好，无需手动配置）」和「手动下载安装（适合有经验开发者，灵活定制）」，下面详细讲解步骤，兼顾你的 macOS 13.2.1 和 Windows 环境。

---

一、 推荐方案：通过 Android Studio 自动安装（优先选择）

Android Studio 会自动管理 Android SDK 的下载、更新和环境变量配置，还能适配后续的 Gradle、模拟器等工具，是新手和团队开发的最优选择。

步骤 1：下载并安装 Android Studio

1. 访问 Android Studio 官方下载页，下载对应系统版本（macOS 或 Windows）。

   • macOS 13.2.1：下载 Mac with Apple Chip（M1/M2/M3）或 Mac with Intel Chip 版本。

   • Windows：下载 Windows (64-bit) 版本（需提前安装 .NET Framework 4.8 和 Visual Studio Build Tools）。

2. 安装流程（下一步式操作，无特殊配置）：

   • macOS：双击 .dmg 文件，将 Android Studio 拖拽到「应用程序」文件夹，启动后按提示完成初始化。

   • Windows：双击 .exe 文件，勾选「Android Studio」和「Android Virtual Device」（模拟器，可选），一路下一步完成安装。

步骤 2：初始化 Android Studio 并安装 SDK

1. 首次启动 Android Studio，会弹出「Android Studio Setup Wizard」（设置向导），选择「Standard」（标准安装，推荐新手），点击「Next」。

2. 选择界面主题（默认 Darcula 深色主题，可按需切换），点击「Next」。

3. 确认 SDK 安装路径（默认路径无需修改，避免中文/空格路径）：

   • macOS：/Users/你的用户名/Library/Android/sdk

   • Windows：C:\Users\你的用户名\AppData\Local\Android\Sdk

4. 点击「Next」，Android Studio 会自动下载并安装：

   • Android SDK 核心包（最新稳定版，如 Android 14 (API 34)）

   • SDK Tools（如 Gradle、Build Tools 等）

   • 可选：Android 模拟器（若需本地调试 App）

5. 等待下载完成（网络不佳可配置国内镜像，见下文「优化技巧」），点击「Finish」完成初始化。

步骤 3：验证 SDK 安装成功

1. 打开 Android Studio，进入「File → Settings → Appearance & Behavior → System Settings → Android SDK」（macOS 为「Android Studio → Settings → Android SDK」）。

2. 在「SDK Platforms」标签页，可看到已安装的 Android 版本（如 API 34），勾选状态为「已安装」。

3. 在「SDK Tools」标签页，可看到「Android SDK Build-Tools」「Android SDK Platform-Tools」「Gradle」等工具已安装，说明 SDK 安装完成。

---

二、 备选方案：手动下载安装 Android SDK（无 Android Studio 场景）

若你仅需 SDK 无需 Android Studio（如仅用于 Flutter/React Native 跨平台开发），可手动下载安装，核心是「下载 SDK 包 + 配置环境变量」。

步骤 1：下载 Android SDK 工具包

1. 访问 Android 开发者官网 SDK 下载页，下滑到「Command line tools only」，下载对应系统版本的命令行工具包：

   • macOS：commandlinetools-mac-xxx_latest.zip

   • Windows：commandlinetools-win-xxx_latest.zip

2. 解压下载的压缩包，创建一个专门存放 Android SDK 的目录（避免中文/空格路径）：

   • macOS：mkdir -p ~/Android/Sdk（解压到 ~/Android/Sdk/cmdline-tools/ 目录下）

   • Windows：创建 C:\Android\Sdk，解压到 C:\Android\Sdk\cmdline-tools\ 目录下

步骤 2：通过命令行安装 SDK 核心组件

1. 打开终端（macOS）或命令提示符（Windows），进入 cmdline-tools 的 bin 目录：

   • macOS：cd ~/Android/Sdk/cmdline-tools/latest/bin

   • Windows：cd C:\Android\Sdk\cmdline-tools\latest\bin

2. 执行命令查看可安装的 SDK 组件：

   # macOS/Linux
   ./sdkmanager --list
   
   # Windows
   sdkmanager --list

3. 安装核心 SDK 组件（必须安装：平台工具、构建工具、最新 Android 平台）：

   # 通用命令（安装 API 34 核心组件，可替换为其他 API 版本）
   # macOS/Linux
   ./sdkmanager "platforms;android-34" "platform-tools" "build-tools;34.0.0"
   
   # Windows
   sdkmanager "platforms;android-34" "platform-tools" "build-tools;34.0.0"

4. 等待下载完成（需同意许可协议，输入 y 确认），核心 SDK 组件会自动安装到对应目录。

步骤 3：配置环境变量（关键，否则命令行无法识别 SDK）

macOS 13.2.1 环境变量配置

1. 打开终端，编辑 bash 或 zsh 配置文件（根据你的终端类型选择）：

   # 若使用 zsh（macOS 默认终端）
   open ~/.zshrc
   
   # 若使用 bash
   open ~/.bash_profile

2. 在配置文件末尾追加以下内容（替换为你的 SDK 实际路径）：

   # Android SDK 根目录
   export ANDROID_HOME=~/Android/Sdk
   # platform-tools 目录（包含 adb、fastboot 等工具）
   export PATH=$PATH:$ANDROID_HOME/platform-tools
   # cmdline-tools bin 目录
   export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin
   # build-tools 目录
   export PATH=$PATH:$ANDROID_HOME/build-tools/34.0.0

3. 保存文件，执行命令使配置生效：

   # zsh 终端
   source ~/.zshrc
   
   # bash 终端
   source ~/.bash_profile

Windows 环境变量配置

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。

2. 在「用户变量」中，点击「新建」，创建变量 ANDROID_HOME，值为 SDK 根目录（如 C:\Android\Sdk）。

3. 编辑「用户变量」中的 Path，添加以下 3 个路径：

   • %ANDROID_HOME%\platform-tools

   • %ANDROID_HOME%\cmdline-tools\latest\bin

   • %ANDROID_HOME%\build-tools\34.0.0

4. 点击「确定」保存所有配置，关闭并重新打开命令提示符。

步骤 4：验证手动安装成功

打开终端/命令提示符，执行以下命令，若能输出版本信息，说明安装并配置成功：

# 验证 adb 工具（平台工具）
adb --version

# 验证 sdkmanager 工具（命令行工具）
sdkmanager --version

---

三、 关键优化技巧（避坑+提速）

1. 配置国内镜像（解决下载缓慢）

由于 Android SDK 资源托管在海外，国内下载缓慢，可配置阿里云镜像：

• 打开 Android Studio →「Settings → System Settings → Android SDK → SDK Update Sites」。

• 点击「Add」，添加以下镜像地址，勾选启用，取消默认官方地址：

  平台镜像：https://mirrors.aliyun.com/android/repository/sdk-tools/latest/
  通用镜像：https://mirrors.aliyun.com/android/repository/

• 手动安装时，可通过 sdkmanager 指定镜像：

  sdkmanager --sdk_root=~/Android/Sdk --repository=https://mirrors.aliyun.com/android/repository/ "platforms;android-34"

1. 避免中文/空格路径

SDK 安装目录和项目目录均不可包含中文、空格或特殊字符，否则会导致 Gradle 编译失败、adb 无法识别设备等问题。

1. 安装对应版本的 Build Tools

不同 Android 项目对 Build Tools 版本有要求，可在 Android Studio 中按需安装（「SDK Tools → 勾选对应 Build Tools 版本」）。

1. 更新 SDK 组件

定期通过 Android Studio 或 sdkmanager --update 命令更新 SDK 组件，修复已知 Bug，提升兼容性。

---

四、 常见问题排查

1. adb 命令未找到 ：环境变量配置错误，重新检查 ANDROID_HOME 和 Path 路径是否正确，重启终端。

2. 下载失败/超时：网络问题，配置国内镜像，或切换稳定网络（如手机热点）。

3. 权限不足（macOS） ：执行 chmod +x 赋予工具执行权限，如 chmod +x ~/Android/Sdk/platform-tools/adb。

4. Windows 缺少 .NET Framework：下载并安装 .NET Framework 4.8，重启电脑后重新安装。

---

总结

1. 新手优先选择Android Studio 自动安装，无需手动配置，高效避坑，适配后续跨平台开发（Flutter/React Native）。

2. 无 Android Studio 需求时，可选择手动下载安装，核心是「解压包 + 安装核心组件 + 配置环境变量」。

3. 关键要点：配置国内镜像提速、避免中文路径、验证 adb 和 sdkmanager 命令确保安装成功。

按以上步骤操作后，即可完成 Android SDK 的安装和配置，后续可正常进行 Android 项目开发或跨平台 App 的 Android 端编译。