Android 命令行工具安装与配置指南

1. 下载命令行工具

访问 Android Studio 官方下载页，找到 “Command line tools only” 部分，下载适用于你操作系统的压缩包。

2. 配置目录结构（关键）

新版工具对目录层级有严格要求，请按以下步骤操作：

创建一个用于存放 Android SDK 的根目录，例如：
- Windows: C:\Android
- macOS/Linux: ~/Android
将下载的 cmdline-tools 压缩包解压，得到 cmdline-tools 文件夹，将其放入上一步创建的 SDK 根目录中（例如 C:\Android\cmdline-tools）。
最关键的一步：在 cmdline-tools 文件夹内部，手动创建一个名为 latest 的子文件夹，然后将 bin、lib 等所有解压出来的文件和文件夹全部移动到 latest 文件夹内。

最终目录结构应如下所示：
```
C:\Android
└── cmdline-tools
    └── latest
        ├── bin
        ├── lib
        └── ...
```

3. 配置环境变量（Windows）

以管理员身份打开 PowerShell，依次执行以下命令（请将 {你的sdk路径} 替换为实际的 SDK 根目录路径，例如 C:\Android）：

# 设置 ANDROID_HOME
[System.Environment]::SetEnvironmentVariable('ANDROID_HOME', '{你的sdk路径}', 'User')

# 获取当前用户的 PATH 并添加必要目录
$currentPath = [System.Environment]::GetEnvironmentVariable('Path', 'User')
[System.Environment]::SetEnvironmentVariable('Path', "$currentPath;{你的sdk路径}\cmdline-tools\latest\bin;{你的sdk路径}\platform-tools;{你的sdk路径}\emulator", 'User')

注意：执行完毕后，必须重启终端（重新打开 PowerShell 或命令提示符）才能使环境变量生效。

4. 安装必要的 SDK 组件

在新的终端中确认 sdkmanager 可用：

sdkmanager --list

然后安装基础组件（版本号可根据需要修改）：

sdkmanager "platform-tools" "build-tools;35.0.0" "platforms;android-35"

最后同意所有许可协议：

sdkmanager --licenses

5. 验证安装

检查 adb 是否能正常运行：

adb --version

如果显示版本信息，说明所有配置成功。

如果需要 macOS/Linux 的环境变量配置方法，可以将 PowerShell 命令替换为以下 bash 命令（将 ~/Android 替换为你的实际路径）：

echo 'export ANDROID_HOME=~/Android' >> ~/.bashrc
echo 'export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator' >> ~/.bashrc
source ~/.bashrc

本文采用 CC BY-NC-SA 4.0 许可协议，转载请标明出处

Android SDK 命令行工具安装