4. Android SDK 组成

本节目标：搞清楚 Android SDK 里到底装了些什么，每个组件干什么用，遇到构建或调试问题时知道是哪一块的事。

SDK 是什么

SDK 全称 Software Development Kit（软件开发工具包）。Android SDK 是 Google 提供的一套工具集合，包含编译、调试、运行 Android 应用所需的一切：API 库、构建工具、模拟器、平台工具等等。

装 Android Studio 时会默认装一份 SDK，后面通过 SDK Manager 管理。SDK 不是一个单一文件，而是一堆组件放在一个目录里（默认 C:\Users\<你>\AppData\Local\Android\Sdk）。

SDK 的几大组件

1. SDK Platforms（平台）

每个 Android 版本对应一个 Platform 包，里面是那个版本的 android.jar—也就是编译时用到的 API 类库。

比如你 compileSdk = 36，那 SDK 目录下就要装 Android 16（API 36）的 Platform。没装的话编译报错，Android Studio 会提示你装。

Sdk/
  platforms/
    android-36/      ← Android 16 Platform
    android-35/      ← Android 15 Platform

2. SDK Platform-Tools（平台工具）

跨版本通用的工具集，独立于具体 Android 版本。核心是 ADB（Android Debug Bridge）：

adb devices 列出连接的设备。
adb install xxx.apk 安装应用。
adb logcat 看日志。
adb push / adb pull 推拉文件。
adb shell 进设备 shell。

还有 fastboot（刷机用，日常开发用得少）和 systrace（性能追踪）。

Tip

ADB 是你以后排查问题的神器。命令行里 adb devices 一敲就知道设备连没连上，比反复重启 Android Studio 高效得多。

3. SDK Build-Tools（构建工具）

构建 APK 用的工具链，包含 aapt（打包资源）、d8/dx（编译 dex）、zipalign（对齐压缩）、apksigner（签名）等。

每个 Build-Tools 有版本号，比如 36.0.0。Android Gradle 插件会指定用哪个版本：

android {
    buildToolsVersion = "36.0.0"
}

新版 Android Studio 通常自动选合适的版本，你一般不用手动改。

4. SDK Tools（旧版 SDK 工具）

这是历史遗留的组件，包含早期的 emulator、sdkmanager 命令行等。现在大部分功能被 Platform-Tools 和 Android Studio 内置取代，但仍可能被某些旧流程依赖。新装的话用不到，知道有这东西就行。

5. Android Emulator（模拟器）

模拟一台 Android 设备跑在你电脑上，不用真机也能测应用。基于 QEMU 虚拟化，支持各种屏幕尺寸、Android 版本、硬件配置。

模拟器需要下载对应的 System Image（系统镜像），比如 android-36 的 Google APIs 镜像。镜像有几种：

标准镜像：纯 AOSP，没有 Google 服务。
Google APIs 镜像：带 Google 服务库（地图、推送等），但没 Play Store。
Google Play 镜像：带完整 Play Store，能装应用，适合测试面向海外的应用。

Note

模拟器吃内存。建议电脑 16GB 起步，模拟器分 2-4GB 才流畅。x86_64 镜像比 arm 快很多，优先选 x86_64。

6. NDK（Native Development Kit）

用 C/C++ 写 Android 代码的工具包。日常用 Kotlin 开发不需要 NDK，但下面这些场景会用到：

游戏引擎（Unity、Unreal 底层）。
图像/视频处理（性能敏感）。
复用已有 C/C++ 库。
加密、签名等防逆向逻辑。

NDK 跟 SDK 是分开的两个东西，需要单独下载。

7. SDK Manager（SDK 管理器）

管理上面这些组件的工具，有图形界面和命令行两种。

图形界面在 Android Studio 里：Settings -> Languages & Frameworks -> Android SDK，能看到 SDK Platforms、SDK Tools 两个 Tab，勾选要装的组件点 Apply 即可。

命令行版叫 sdkmanager，在 Sdk/cmdline-tools/bin/ 下，适合 CI/CD 或无界面环境：

sdkmanager --list
sdkmanager "platforms;android-36" "build-tools;36.0.0"

一个典型 SDK 目录长啥样

Sdk/
├── platforms/           # SDK Platforms（各版本 android.jar）
│   └── android-36/
├── platform-tools/      # adb、fastboot
├── build-tools/         # 各版本构建工具
│   └── 36.0.0/
├── emulator/            # 模拟器
├── system-images/       # 模拟器系统镜像
│   └── android-36/
├── ndk/                 # NDK（可选）
├── cmdline-tools/       # sdkmanager 等命令行工具
└── licenses/            # 各组件授权（同意后才能用）

环境变量配置（可选）

如果你想命令行直接用 adb、sdkmanager，可以把 SDK 相关路径加到系统 PATH：

%LOCALAPPDATA%\Android\Sdk\platform-tools
%LOCALAPPDATA%\Android\Sdk\cmdline-tools\latest\bin

配置后重启终端，敲 adb version 能看到版本号就成功了。

Warning

不要手动改 SDK 目录里的文件。所有组件增删都走 SDK Manager，否则 Android Studio 可能识别异常。

怎么判断该装哪些

新装 Android Studio 时选 Standard 安装会自动帮你装好常用组件，一般够用。需要补的常见场景：

升级 compileSdk 时 -> 装对应版本的 Platform。
测试不同 Android 版本 -> 装对应 System Image。
用 C++ -> 装 NDK 和 CMake。
CI 构建机器 -> 用 sdkmanager 命令行装。

小结

Android SDK 由 Platforms（API 库）、Platform-Tools（ADB 等）、Build-Tools（打包工具）、Emulator（模拟器）、NDK（C/C++）等组件组成，用 SDK Manager 统一管理。日常开发最常打交道的是 ADB 和 Platform。下一节动手装 Android Studio。