Question

如前文所述，Spring Boot CLI 提供了一种有趣的、不同寻常的 Spring 应用程序开发方式。第 5 章里会详细解释 CLI 提供的功能。这里先来看看如何安装 Spring Boot CLI，这样才能运行代码清单 1-1。

Spring Boot CLI 有好几种安装方式。

• 用下载的分发包进行安装。

• 用 Groovy Environment Manager 进行安装。

• 通过 OS X Homebrew 进行安装。

• 使用 MacPorts 进行安装。

我们分别看一下这几种方式。除此之外，还要了解如何安装 Spring Boot CLI 的命令行补全支持，如果你在 BASH 或 zsh shell 里使用 CLI，这会非常有用（抱歉了，各位 Windows 用户）。先来看看如何用分发包手工安装 Spring Boot CLI 吧。

1. 手工安装 Spring Boot CLI

安装 Spring Boot CLI 最直接的方法大约是下载、解压，随后将它的 bin 目录添加到系统路径里。你可以从以下两个地址下载分发包：

• http://repo.spring.io/release/org/springframework/boot/spring-boot-cli/1.3.0.RELEASE/spring-boot-cli-1.3.0.RELEASE-bin.zip

• http://repo.spring.io/release/org/springframework/boot/spring-boot-cli/1.3.0.RELEASE/spring-boot-cli-1.3.0.RELEASE-bin.tar.gz

下载完成之后，把它解压到文件系统的任意目录里。在解压后的目录里，你会找到一个 bin 目录，其中包含了一个 spring.bat 脚本（用于 Windows 环境）和一个 spring 脚本（用于 Unix 环境）。把这个 bin 目录添加到系统路径里，然后就能使用 Spring Boot CLI 了。

为 Spring Boot 建立符号链接 如果是在安装了 Unix 的机器上使用 Spring Boot CLI，最好建立一个指向解压目录的符号链接，然后把这个符号链接添加到系统路径，而不是实际的目录。这样后续升级 Spring Boot 新版本，或是转换版本，都会很方便，只要重建一下符号链接，指向新版本就好了。

你可以先浅尝辄止，看看你所安装的 CLI 版本号：

$ spring --version

如果一切正常，你会看到安装好的 Spring Boot CLI 的版本号。

虽然这是手工安装，但一切都很容易，而且不要求你安装任何附加的东西。如果你是 Windows 用户，也别无选择，这是唯一的安装方式。但如果你使用的是 Unix 机器，而且想要稍微自动化一点的方式，那么可以试试 Software Development Kit Manager。

2. 使用 Software Development Kit Manager 进行安装

软件开发工具管理包（Software Development Kit Manager，SDKMAN，曾用简称 GVM）也能用来安装和管理多版本 Spring Boot CLI。使用前，你需要先从 http://sdkman.io 获取并安装 SDKMAN。最简单的安装方式是使用命令行：

$ curl -s get.sdkman.io | bash

跟随输出的指示就能完成 SDKMAN 的安装。在我的机器上，我在命令行里执行了如下命令：

$ source "/Users/habuma/.sdkman/bin/sdkman-init.sh"

注意，用户不同，这条命令也会有所不同。我的用户目录是/Users/habuma，因此这也是 shell 脚本的根路径。你需要根据实际情况稍作调整。一旦安装好了 SDKMAN，就可以用下面的方式来安装 Spring Boot CLI 了：

$ sdk install springboot
$ spring --version

假设一切正常，你将看到 Spring Boot 的当前版本号。

如果想升级新版本的 Spring Boot CLI，只需安装并使用即可。使用 SDKMAN 的 list 命令可以找到可用的版本：

$ sdk list springboot

list 命令列出了所有可用版本，包括已经安装的和正在使用的。从中选择一个进行安装，然后就可以正常使用。举例来说，要安装 Spring Boot CLI 1.3.0.RELEASE，直接使用 install 命令，指定版本号：

$ sdk install springboot 1.3.0.RELEASE

这样就会安装一个新版本，随后你会被询问是否将其设置为默认版本。要是你不想把它作为默认版本，或者想要切换到另一个版本，可以用 use 命令：

$ sdk use springboot 1.3.0.RELEASE

如果你希望把那个版本作为所有 shell 的默认版本，可以使用 default 命令：

$ sdk default springboot 1.3.0.RELEASE

使用 SDKMAN 来管理 Spring Boot CLI 有一个好处，你可以便捷地在 Spring Boot 的不同版本之间切换。这样你可以在正式发布前试用快照版本（snapshot）、里程碑版本（milestone）和尚未正式发布的候选版本（release candidate），试用后再切回稳定版本进行其他工作。

3. 使用 Homebrew 进行安装

如果要在 OS X 的机器上进行开发，你还可以用 Homebrew 来安装 Spring Boot CLI。Homebrew 是 OS X 的包管理器，用于安装多种不同应用程序和工具。要安装 Homebrew，最简单的方法就是运行安装用的 Ruby 脚本：

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

你可以在 http://brew.sh 看到更多关于 Homebrew 的内容（还有安装方法）。

要用 Homebrew 来安装 Spring Boot CLI，你需要引入 Pivotal 的 tap2 ：

2 tap 是向 Homebrew 添加额外仓库的一种途径。Pivotal 是 Spring 及 Spring Boot 背后的公司，通过它的 tap 可以安装 Spring Boot。

$ brew tap pivotal/tap

在有了 Pivotal 的 tap 后，就可以像下面这样安装 Spring Boot CLI 了：

$ brew install springboot

Homebrew 会把 Spring Boot CLI 安装到/usr/local/bin，之后可以直接使用。可以通过检查版本号来验证安装是否成功：

$ spring --version

这条命令应该会返回刚才安装的 Spring Boot 版本号。你也可以运行代码清单 1-1 看看。

4. 使用 MacPorts 进行安装

OS X 用户还有另一种安装 Spring Boot CLI 的方法，即使用 MacPorts，这是 Mac OS X 上另一个流行的安装工具。要使用 MacPorts 来安装 Spring Boot CLI，必须先安装 MacPorts，而 MacPorts 还要求安装 Xcode。此外，使用不同版本的 OS X 时，MacPorts 的安装步骤也会有所不同。因此我建议你根据 https://www.macports.org/install.php 的安装指南来安装 MacPorts。

一旦安装好了 MacPorts，就可以用以下命令来安装 Spring Boot CLI 了：

$ sudo port install spring-boot-cli

MacPorts 会把 Spring Boot CLI 安装到/opt/local/share/java/spring-boot-cli，并在/opt/local/bin 里放一个指向其可执行文件的符号链接。在安装 MacPorts 后，/opt/local/bin 这个目录应该就在系统路径里了。你可以检查版本号来验证安装是否成功：

$ spring --version

这条命令应该会返回刚才安装的 Spring Boot 的版本号。你也可以运行代码清单 1-1，看看效果如何。

5. 开启命令行补全

Spring Boot CLI 为基于 CLI 的应用程序的运行、打包和测试提供了一套好用的命令。而且，每个命令都有好多选项。要记住这些东西实属不易，命令行补全能帮助记忆怎么使用 Spring Boot CLI。

如果用 Homebrew 安装 Spring Boot CLI，那么命令行补全已经安装完毕。但如果是手工安装或者用 SDKMAN 安装的，那就需要执行脚本或者手工安装。（如果是通过 MacPorts 安装的 Spring Boot CLI，那么你不必考虑命令行补全。）

你可以在 Spring Boot CLI 安装目录的 shell-completion 子目录里找到补全脚本。有两个不同的脚本，一个是针对 BASH 的，另一个是针对 zsh 的。要使用 BASH 的补全脚本，可以在命令行里键入以下命令（假设安装时用的是 SDKMAN）：

$ . ~/.sdkman/springboot/current/shell-completion/bash/spring

这样，在当前的 shell 里就可以使用 Spring Boot CLI 的补全功能了，但每次开启一个新的 shell 都要重新执行一次上面的命令才行。你也可以把这个脚本复制到你的个人或系统脚本目录里，这个目录的位置在不同的 Unix 里也会有所不同，可以参考系统文档（或 Google）了解细节。

开启了命令行补全之后，在命令行里键入 spring 命令，然后按 Tab 键就能看到下一步该输什么的提示。选中一个命令后，键入 -- （两个连字符）后再按 Tab，就会显示出该命令的选项列表。

如果你在 Windows 上进行开发，或者没有用 BASH 或 zsh，那就无缘使用这些命令行补全脚本了。尽管如此，如果你用的是 Spring Boot CLI 的 shell，那一样也有命令补全：

$ spring shell

和 BASH、zsh 的命令补全脚本（在 BASH/zsh shell 里执行的）不同，Spring Boot CLI shell 会新开一个特别针对 Spring Boot 的 shell，在里面可以执行各种 CLI 命令，Tab 键也能有命令补全。

Spring Boot CLI 为 Spring Boot 提供了快速上手和构建简单原型应用程序的途径。稍后将在第 8 章中讲到，在正确的生产运行时环境下，它也能用于开发生产应用程序。

尽管如此，与大部分 Java 项目的开发相比，Spring Boot CLI 的流程还是不太符合常规。通常情况下，Java 项目用 Gradle 或 Maven 这样的工具构建出 WAR 文件，再把这些文件部署到应用服务器里。即便 CLI 模型让你感到不太舒服，你仍然可以在传统方式下充分利用大部分 Spring Boot 特性。3 Spring Initializr 可以成为你万里长征的第一步。

3 只是要放弃那些用到 Groovy 语言灵活性的特性，比如自动依赖和 import 解析。