Android SDK 为何缺失 tools 目录？

Question

在某些Android SDK安装或更新后，开发者发现SDK根目录下缺失`tools`文件夹，导致无法使用`adb`、`fastboot`或`sdkmanager`等关键工具。此问题通常源于新版Android Studio采用模块化SDK组件管理机制，将原`tools`目录拆分为`platform-tools`与`cmdline-tools`两个独立组件，默认未完整安装所致。

Answer 1

1. 问题现象与背景分析

在升级或全新安装 Android SDK 后，部分开发者发现其 SDK 根目录下缺失 tools 文件夹。这导致无法直接使用 adb、fastboot 和 sdkmanager 等核心命令行工具。该问题并非安装失败，而是自 Android Studio 4.1 起引入的模块化 SDK 组件管理机制所致。

传统上，所有开发工具集中于 $ANDROID_SDK_HOME/tools/ 目录中。但新版 SDK 将其拆分为两个独立组件：

• platform-tools：包含 adb、fastboot 等设备通信工具
• cmdline-tools：提供 sdkmanager、avdmanager 等 SDK 管理功能

默认情况下，Android Studio 仅自动安装必要的 GUI 工具链，而未强制安装完整命令行支持组件，从而造成“工具缺失”的错觉。

2. 技术演进路径与设计动机

版本阶段	SDK 结构	关键变化	影响范围
Pre-AS 4.1	单一 tools 目录	集成式工具包	所有开发者共享同一结构
AS 4.1+	拆分 platform-tools / cmdline-tools	模块化、按需加载	提升更新效率与安全性
AS Giraffe (2022.3.1)+	cmdline-tools 分级（latest, 3.x）	支持多版本共存	便于 CI/CD 环境控制

3. 诊断流程与检测方法

1. 检查 SDK 安装路径：echo $ANDROID_HOME 或查看 AS 设置中的 SDK Location
2. 列出当前已安装组件：ls $ANDROID_HOME
3. 确认是否存在以下目录：
   • platform-tools/ → 应含 adb、fastboot
   • cmdline-tools/latest/bin/ → 应含 sdkmanager
4. 执行 sdkmanager --list_installed 查看已安装包
5. 若提示 command not found，则说明 cmdline-tools 未正确安装或未加入 PATH

4. 解决方案详解

方案一：通过 Android Studio SDK Manager 安装

Preferences → Appearance & Behavior → System Settings → Android SDK
  → SDK Tools → 勾选 "Android SDK Platform-Tools" 和 "Android SDK Command-line Tools (latest)"
  → Apply 完成安装

方案二：命令行手动安装（适用于自动化环境）

# 下载并解压 cmdline-tools 到 $ANDROID_HOME/cmdline-tools/latest/
wget https://dl.google.com/android/repository/commandlinetools-linux-9477386_latest.zip
unzip commandlinetools-linux-*.zip -d temp_cmdtool/
mkdir -p $ANDROID_HOME/cmdline-tools/latest
mv temp_cmdtool/cmdline-tools/* $ANDROID_HOME/cmdline-tools/latest/ 2>/dev/null || true

# 验证安装
$ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager --version

5. 环境变量配置最佳实践

为确保全局可访问，建议将以下路径添加至 shell 配置文件（如 ~/.zshrc 或 ~/.bashrc）：

export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin
export PATH=$PATH:$ANDROID_HOME/emulator

验证方式：

source ~/.zshrc
adb version
sdkmanager --help

6. CI/CD 流水线中的应对策略

graph TD A[CI Runner 初始化] --> B{检测 cmdline-tools} B -- 不存在 --> C[下载 latest 命令行工具] B -- 存在 --> D[继续构建] C --> E[解压至 SDK 路径] E --> F[运行 sdkmanager 更新组件] F --> G[安装 platform-tools, build-tools] G --> H[执行测试/打包]

7. 常见误区与避坑指南

• 误认为 SDK 损坏而重装整个 Android Studio —— 实际只需补装组件
• 混淆 cmdline-tools 与旧版 tools 目录功能边界
• 未设置环境变量导致本地可用但脚本失败
• 在容器环境中遗漏非交互式授权处理：yes | sdkmanager --licenses
• 忽略版本冲突：多个 cmdline-tools 版本共存时优先级混乱