打开 SDK 命令提示符:在 Windows 开始菜单中找到 SDK 目录下的命令提示符快捷方式并点击;或手动打开命令提示符,导航至 SDK 安装目录(如
Android\Sdk\tools\bin
)后执行命令(如sdkmanager
)。
在使用软件开发工具包(SDK)进行开发时,经常需要在特定的命令行环境中执行命令,例如编译代码、运行工具(如 adb
, fastboot
, emulator
等)或管理 SDK 组件,这个特定的命令行环境通常被称为 SDK 命令提示符 或 SDK 终端,它之所以特殊,是因为它预先配置好了 SDK 工具所在目录的路径(PATH
环境变量),让你无需手动切换到 SDK 的安装目录或输入完整路径就能直接使用这些工具。
以下是在不同操作系统和开发环境下打开 SDK 命令提示符的详细方法:
在 Windows 系统上
这是最常见的情况,特别是进行 Android 或 Windows 开发时。
-
通过 SDK 管理器或 IDE 的快捷方式 (推荐且最准确):
- Android Studio (Android SDK):
- 安装 Android Studio 时,通常会在开始菜单创建快捷方式文件夹(
Android Studio
)。 - 在这个文件夹里,寻找名为
SDK Manager
或AVD Manager
的快捷方式。右键点击 它们。 - 在弹出的右键菜单中,选择 “打开文件所在的位置” 或 “更多” > “打开文件位置”。
- 在打开的文件夹中,你应该能看到一个名为
cmdline-tools
或直接包含tools
或platform-tools
的文件夹。双击进入 这个文件夹(通常是...\Sdk\platform-tools
或...\Sdk\cmdline-tools\latest\bin
)。 - 在此文件夹的地址栏中,清空地址栏内容,输入
cmd
,然后按 回车键,这将在此目录下打开一个标准的命令提示符窗口,并且该目录下的工具(如adb
,fastboot
)可以直接使用。 - 更优方法: 在上一步的文件夹中(如
platform-tools
),按住Shift
键,同时右键点击文件夹的空白区域,在右键菜单中,选择 “在此处打开 Powershell 窗口” 或 “在此处打开命令窗口”,这同样能达到目的,且是官方推荐的方式之一。
- 安装 Android Studio 时,通常会在开始菜单创建快捷方式文件夹(
- Visual Studio (Windows SDK 或其他 SDK):
- 在开始菜单中找到 Visual Studio 的文件夹(
Visual Studio 2022
)。 - 在该文件夹内,寻找名为
Developer Command Prompt for VS 2022
或类似名称(年份可能不同)的快捷方式。直接点击它。 - 这个命令提示符是专门为 Visual Studio 配置的,不仅包含了 Windows SDK 的路径,还包含了 Visual Studio 编译器等工具的路径,是进行 Windows 开发的理想环境。
- 在开始菜单中找到 Visual Studio 的文件夹(
- Android Studio (Android SDK):
-
手动打开命令提示符并配置路径 (通用方法):
- 按
Win + R
键打开“运行”对话框。 - 输入
cmd
或powershell
,然后按回车,打开命令提示符或 PowerShell 窗口。 - 你需要手动切换到 SDK 工具所在的目录,最常见的是
platform-tools
和tools
目录,假设你的 Android SDK 安装在C:\Users\YourName\AppData\Local\Android\Sdk
:- 输入
cd C:\Users\YourName\AppData\Local\Android\Sdk\platform-tools
然后回车。 - 或者
cd C:\Users\YourName\AppData\Local\Android\Sdk\tools
然后回车。
- 输入
- 现在你就可以在当前目录下运行
adb
,fastboot
,emulator
等命令了(需要输入命令全名如adb devices
)。 - 缺点: 每次打开新窗口都需要手动切换目录;如果工具不在当前目录,需要输入完整路径(如
.\adb devices
)。
- 按
-
将 SDK 工具目录添加到系统 PATH 环境变量 (一劳永逸):
- 这是最方便的方法,配置好后,在任何普通的命令提示符或 PowerShell 窗口中都可以直接使用 SDK 命令。
- 步骤:
- 右键点击“此电脑”或“我的电脑”,选择“属性”。
- 点击“高级系统设置”。
- 在“系统属性”窗口的“高级”选项卡下,点击“环境变量”按钮。
- 在“系统变量”区域,找到名为
Path
的变量,选中它,点击“编辑”。 - 点击“新建”,然后添加你的 SDK 工具目录的完整路径,对于 Android SDK,通常需要添加两个:
...\Sdk\platform-tools
(包含adb
,fastboot
)...\Sdk\tools
(包含android
,emulator
等旧工具,新版本可能在...\Sdk\cmdline-tools\latest\bin
)...\Sdk\emulator
(包含emulator
可执行文件,有时需要单独添加)
- 重要: 将 替换为你电脑上 SDK 的实际安装路径。
C:\Users\YourName\AppData\Local\Android\Sdk\platform-tools
。 - 逐一点击“确定”保存所有更改。
- 验证: 打开一个新的命令提示符或 PowerShell 窗口(重要!必须新开窗口使 PATH 生效),输入
adb version
或fastboot --version
,如果看到版本信息而不是“不是内部或外部命令”的错误,说明配置成功。 - 优点: 全局可用,无需切换目录或使用特定快捷方式。
- 注意: 修改系统 PATH 需谨慎,确保添加的路径正确无误,建议只添加必要的 SDK 工具路径。
在 macOS 和 Linux 系统上
在 macOS 和 Linux 上,概念类似,但操作主要在终端(Terminal)中进行。
-
通过 IDE 的终端集成 (推荐):
- Android Studio: 在 Android Studio 底部有一个 “Terminal” 标签页,点击它打开的终端会话,通常已经配置好了 Android SDK 的路径(尤其是
platform-tools
和emulator
),可以直接使用adb
,fastboot
,emulator
等命令。 - 其他 IDE (如 VS Code): 许多 IDE 都有集成的终端,但可能需要你手动配置终端启动时自动加载 SDK 路径(通过 Shell 的配置文件如
~/.bashrc
,~/.zshrc
)。
- Android Studio: 在 Android Studio 底部有一个 “Terminal” 标签页,点击它打开的终端会话,通常已经配置好了 Android SDK 的路径(尤其是
-
手动打开终端并配置路径 (最常用):
- 打开“终端”应用程序(在 macOS 的
应用程序/实用工具
下,在 Linux 的应用程序菜单中通常能找到)。 - 与 Windows 的手动方法类似,你需要:
- 切换到 SDK 工具目录: 使用
cd
命令。
cd ~/Library/Android/sdk/platform-tools
(macOS 默认 Android SDK 位置)
cd /home/yourname/Android/Sdk/platform-tools
(Linux 常见位置) - 或者,将 SDK 工具目录添加到用户的
PATH
环境变量 (推荐):- 打开你的 Shell 配置文件(对于 Bash:
~/.bashrc
或~/.bash_profile
;对于 Zsh:~/.zshrc
),可以使用nano
或vim
编辑:nano ~/.zshrc
。 - 在文件末尾添加类似以下的行(替换为你的实际路径):
export PATH=$PATH:~/Library/Android/sdk/platform-tools
export PATH=$PATH:~/Library/Android/sdk/tools
(如果需要)
export PATH=$PATH:~/Library/Android/sdk/emulator
(如果需要) - 保存文件(在 nano 中按
Ctrl+O
回车,Ctrl+X
退出)。 - 让配置立即生效:执行
source ~/.zshrc
(或source ~/.bashrc
,根据你修改的文件而定)。
- 打开你的 Shell 配置文件(对于 Bash:
- 切换到 SDK 工具目录: 使用
- 验证: 在任何新的终端窗口或标签页中,输入
adb version
,应该能正确输出版本信息。
- 打开“终端”应用程序(在 macOS 的
找不到 SDK 命令提示符或工具?
- 确认 SDK 已安装: 首先确保你需要的 SDK(如 Android SDK, Windows SDK)已经正确安装在你的电脑上,可以通过相应的 SDK 管理器(Android Studio 内的 SDK Manager, Visual Studio Installer)检查。
- 确认工具目录存在: 检查 SDK 安装目录下是否存在
platform-tools
,tools
,cmdline-tools
等子目录,有时需要单独安装这些组件。 - 检查 PATH 配置: 如果你使用了添加 PATH 的方法,请仔细检查路径是否拼写正确,是否包含了必要的目录(特别是
platform-tools
),以及是否在修改 PATH 后打开了新的命令提示符/终端窗口。 - 以管理员身份运行 (Windows): 某些 SDK 操作(尤其是涉及设备或安装驱动的)可能需要管理员权限,在 Windows 上,右键点击命令提示符或 PowerShell 快捷方式,选择“以管理员身份运行”。
- 查看官方文档: 特定 SDK 的官方安装和配置指南是最权威的参考,Android 开发者网站有详细的 命令行工具文档。
打开“SDK 命令提示符”的核心目的是让命令行环境能够直接访问 SDK 提供的工具(如 adb
, fastboot
, emulator
, 编译器命令等),最推荐的方法是:
- 利用 IDE 提供的专用终端或快捷方式(如 Android Studio 的 Terminal 面板、Visual Studio 的 Developer Command Prompt),这是最省心且保证环境正确的。
- 将 SDK 的关键工具目录(主要是
platform-tools
)永久添加到系统的PATH
环境变量中,这样在任何普通命令行窗口都可以直接使用这些命令,是最灵活方便的方式。
理解 PATH
环境变量的作用以及如何配置它是掌握命令行开发环境的关键一步,希望这篇指南能帮助你顺利打开并使用 SDK 命令提示符!
引用与参考说明:
- 本文中关于 Android SDK 路径和工具使用的信息,参考了 Android 开发者官方文档关于命令行工具的说明。
- Windows SDK 开发人员命令提示符的使用方式,参考了 Microsoft Visual Studio 官方文档中关于使用命令行的介绍。
- 环境变量
PATH
的概念和配置方法属于操作系统(Windows, macOS, Linux)的基础知识,参考了各操作系统相关的用户手册和通用技术文档。 - 具体操作步骤基于当前主流操作系统版本(Windows 10/11, macOS Monterey/Ventura, 常见 Linux 发行版)和开发工具版本(Android Studio, Visual Studio)的常见实践。
原创文章,发布者:酷番叔,转转请注明出处:https://cloud.kd.cn/ask/5137.html