sdkmanager
是一个命令行工具,您可以用它来查看、安装、更新和卸载 Android SDK 的软件包。如果您使用 Android Studio,则无需使用此工具,而可以从 IDE 管理 SDK 软件包。
sdkmanager
工具在 Android SDK Tools 软件包(25.2.3 及更高版本)中提供,并位于 android_sdk/cmdline-tools/latest/bin/
下。
用法
您可以使用 sdkmanager
执行以下任务。
列出已安装和可用的软件包
sdkmanager --list [options] \ [--channel=channel_id] // Channels: 0 (stable), 1 (beta), 2 (dev), or 3 (canary)
使用 channel
选项,列出从 channel_0 到 channel_id
(含)的所有渠道中的软件包。例如,指定 Canary 版渠道以列出所有渠道的软件包。
安装软件包
sdkmanager packages [options]
packages 参数是 --list
命令列出的 SDK 式的路径,这些路径括在引号中(例如 "build-tools;30.0.2"
或 "platforms;android-28"
)。您可以传递多个软件包路径(用空格分隔),但各个路径必须括在各自的一组引号中。
例如,下面展示了如何安装最新的平台工具(包括 adb
和 fastboot
)以及适用于 API 级别 28 的 SDK 工具:
sdkmanager "platform-tools" "platforms;android-28"
或者,您也可以传递一个指定了所有软件包的文本文件:
sdkmanager --package_file=package_file [options]
package_file
若要卸载软件包,只需添加 --uninstall
标记:
sdkmanager --uninstall packages [options] sdkmanager --uninstall --package_file=package_file [options]
如需安装 CMake 或 NDK,请使用以下语法:
sdkmanager --install ["ndk;major.minor.build[suffix]" | "cmake;major.minor.micro.build"] [--channel=channel_id] // NDK channels: 0 (stable), 1 (beta), or 3 (canary)
例如,使用以下命令安装指定 NDK 版本(无论其当前位于哪个渠道)。
sdkmanager --install "ndk;21.3.6528147" --channel=3 // Install the NDK from the canary channel (or below) sdkmanager --install "cmake;10.24988404" // Install a specific version of CMake
更新所有已安装的软件包
sdkmanager --update [options]
选项
下表列出了上述命令的可用选项。
选项 | 说明 |
---|---|
--sdk_root=path
|
使用指定的 SDK 路径而不是包含此工具的 SDK |
--channel=channel_id
|
纳入从 channel_0 到 channel_id(含)的所有渠道中的软件包。可用的渠道包括:
|
--include_obsolete
|
在列出或更新软件包时纳入已过时的软件包。
仅适用于 --list 和 --update 。
|
--no_https
|
强制所有连接使用 HTTP 而不是 HTTPS。 |
--verbose
|
详细输出模式。该模式会输出错误、警告和参考性消息。 |
--proxy={http | socks}
|
通过给定类型的代理建立连接:用 http 指定一个高层级协议(如 HTTP 或 FTP)的代理,或用 socks 指定一个 SOCKS(V4 或 V5)代理。
|
--proxy_host={IP_address | DNS_address}
|
要使用的代理的 IP 或 DNS 地址。 |
--proxy_port=port_number
|
要连接到的代理端口号。 |