用CLI安装Android SDK

在进行个人的Android开发环境准备时，通过Android Studio可以在一个漂亮的图形界面，安装、配置Android SDK。 但它也可以通过纯CLI的方式完成，有时反而更方便。

Bootstrap ¶

在已经有tools组件后，自然就可以在CLI管理Android SDK的所有组件。 但是，在一无所有时，自然需要自举（Bootstrap），初始化一个tools组件。

wget https://dl.google.com/android/repository/sdk-tools-linux-3859397.zip
unzip sdk-tools-linux-3859397.zip

解压后，在./tools/bin/sdkmanager位置的这个可执行文件，就是管理Android SDK的CLI工具。

以上是tools的26.0.1Linux版本，在预订要放置Android SDK的目录，下载后解压，即安装完成。 这个版本来源于最新的tools下载页面。 如果与本文的发布时间相隔甚远，可以通过访问这个页面，获取较新的下载链接。

当然，访问该页面需要自备墙梯。 下载却不用，因为域名是dl.google.com，可见俺们的墙也是很鸡贼的。 为了省事，这里把Mac和Windows的下载链接一并给出。 后面的介绍仍然以Linux为例。

（不要担忧这个版本会过时，因为已经过时了。不过自举完成后，就可自我更新。）

Licenses ¶

要使用Android SDK的相关组件前，需要接受5个用户协议。 懂法律的朋友可以仔细看一下。 看不懂，或者信任Google的朋友，为了避免麻烦，可以统一接受这5个协议。

yes | ./tools/bin/sdkmanager --licenses

更新sdkmanager ¶

由于文档总是滞后于开发，所以刚下载的tools，往往是旧版本。 在《SDK Tools Release Notes | Android Studio》页面，可以看到最新发布的tools版本信息。

孤刚下载的是26.0.1，而最新已经是26.1.1了。 它对sdkmanager的界面显示做了一些优化。 26.0.1版本的--list对显示做了折叠，基本没法用，必须再加上--verbose参数才能得到完整的可用信息。 所以，这个更新还是很有必要的。 （它也会顺便安装emulator、patcher;v4、platform-tools三个组件。）

$ ./tools/bin/sdkmanager tools
done

可以通过--help，查看sdkmanager的帮助文档。 也可访问《sdkmanager | Android Studio》，在线查看。

列出SDK组件 ¶

在以前，都是使用./tools/android来做SDK管理，但近期已被废弃。 比如，列出SDK的组件。

$ ./tools/android list sdk
*************************************************************************
The "android" command is deprecated.
For manual SDK, AVD, and project management, please use Android Studio.
For command-line tools, use tools/bin/sdkmanager and tools/bin/avdmanager
*************************************************************************
"android" SDK commands can be translated to sdkmanager commands on a best-effort basis.
Continue? (This prompt can be suppressed with the --use-sdk-wrapper command-line argument
or by setting the USE_SDK_WRAPPER environment variable) [y/N]:

现在使用./tools/bin/sdkmanager --list，来列出已安装和可安装的组件。 sdkmanager替代了原./tools/android的SDK管理功能。 （avdmanager替代了虚拟设备的管理功能。）

sdkmanager可以按版本查看、安装、卸载Android的组件。 以下列出当前（2018年3月）的可用组件：

以上表格为命令行显示整理后的结果，分三列。 第二列是版本，第三列是描述，和UI上的安卓管理器的显示类似。

第一列Path，含义是组件名称，可能还会加上版本，以分号;隔开。 这其实也是本地安装路径，只要把分号;看作/。 把Path的内容直接放到./tools/bin/sdkmanager后，就可安装这个组件。

安装组件 ¶

直接在sdkmanager后，加上SDK组件的Path，就可以安装，一次一个。 但是注意，由于这里的Path愚蠢地以分号;来作为分隔符，所以需要加上单引号''或双引号""，否则Shell会识别有误。 以下以build-tools为例：

$ ./tools/bin/sdkmanager build-tools;27.0.3
Warning: Failed to find package build-tools
bash: 27.0.3: command not found
$ ./tools/bin/sdkmanager 'build-tools;27.0.3'
[=======================================] 100% Unzipping... android-8.1.0/jack-j

（26.1.1版本的CLI显示，仍然有很多需要忍受的问题。）

卸载组件 ¶

如果不是硬盘不够，通常是不需要卸载的。 版本敏感的SDK组件，都已经分版本放置了，多版本可以共存。 所以SDK只需要不断更新即可。

但如果确实要卸载，可以用--uninstall参数。

$ ./tools/bin/sdkmanager --uninstall 'build-tools;27.0.3'
[=======================================] 100% Fetch remote repository...

（忍……）

更新组件 ¶

有些组件是统一用一个版本的，比如tools、platform-tools。 有些组件本身是对应某个Android版本、甚至架构的，比如platforms;android-27、system-images;android-27;google_apis_playstore;x86。 如果要统一更新所有已安装组件，可以用--update参数。

$ ./tools/bin/sdkmanager --update
[=======================================] 100% Computing updates...

（继续忍……）

总结 ¶

Android SDK组件繁多，又有必要和可选之分。 有这样一个CLI的方式进行管理，在进行大规模或重复性环境准备时，是很方便的。

就是这CLI的品质……