安装

Spring CLI 提供多种格式,您可以选择自己喜欢的安装方法。可下载的文件可在发布页面找到。

二进制版本

  • Windows

  • Linux

  • Mac

  • 通用

手动
  • spring-cli-standalone-<version>-windows.x86_64.zip - 捆绑了 x86 JDK

  • spring-cli-installer-<version>-windows-x86_64.msi - 捆绑了 x86 JDK 的 msi 安装包

手动
  • spring-cli-standalone-<version>-linux.x86_64.zip - 捆绑了 x86 JDK

  • spring-cli-installer-<version>-1.x86_64.rpm - 捆绑了 x86 JDK 的 rpm 安装包

  • spring-cli-installer<version>-1_amd64.deb_ - 捆绑了 x86 JDK 的 deb 安装包

Homebrew Tap
brew tap spring-cli-projects/spring-cli
brew install spring-cli
手动
  • spring-cli-standalone-<version>-osx.x86_64.zip - 捆绑了 x86 JDK

  • spring-cli-standalone-<version>-osx.aarch64.zip - 捆绑了 arm JDK

Homebrew Tap

Tap 公式根据您的 brew 设置在 x86aarch64 之间进行选择。

brew tap spring-cli-projects/spring-cli
brew install spring-cli
手动
  • spring-cli-<version>.jar - 普通 fat jar,需要单独安装 JDK17

  • spring-cli-<version>.zip - 包含启动脚本的普通 fat jar,需要单独安装 JDK17

获取 Snapshot 二进制文件

最新的 snapshot 二进制文件可在 GitHub Releases early-access 中获取。

您还可以从源代码构建 uber-jar,详情请参阅本页稍后内容

从源代码构建

需要安装 Java 17

即使您在 Java 11 或 Java 8 项目上使用 Spring CLI,CLI 本身也需要能够访问 Java 17 的安装。

创建一个指向您的 Java 17 安装路径的 JAVA_HOME 环境变量。例如,对于 bash shell,您可以运行以下命令

export JAVA_HOME=jdk-install-dir
export PATH=$JAVA_HOME/bin:$PATH

这是 OpenRewrite 所必需的,OpenRewrite 在内部使用。

构建说明

要自己构建 jar,请运行以下命令

git clone https://github.com/spring-projects/spring-cli $HOME/temp/spring-cli

cd $HOME/temp/spring-cli

./gradlew clean build -x test

现在创建一个别名,以便使用命令 'spring' 调用 CLI

alias spring='java -jar $HOME/temp/spring-cli/build/libs/spring-cli-0.9.0.jar'

交互模式

除了使用别名运行 Spring Boot uber-jar 或在命令行中使用 spring 运行原生二进制文件外,您还可以进入交互模式,Spring CLI 会持续运行。在这种情况下,您无需添加 spring 关键字来运行命令。

交互模式提供命令选项补全,但您也可以依赖位置选项值。

命令补全

在非交互模式下,您可以通过运行以下命令在 shell 中获得命令补全

eval "$(java -jar $HOME/temp/spring-cli/build/libs/spring-cli-0.9.0.jar completion bash)"
如果您已配置 docs.brew.sh/Shell-Completion,Homebrew formula 会设置 bash 补全。

获取帮助

spring help 命令显示所有命令的帮助信息。

要获取特定命令的帮助信息,请键入 spring help 加上命令和子命令名称,例如 spring help boot new