Installation

Spring CLI 提供了多种格式，让您可以选择喜欢的安装方法。可从 Release Page 下载工件。

Binary Release

Windows
Manually

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

  • spring-cli-installer-<version>-windows-x86_64.msi - msi 安装程序，附带 x86 JDK

Linux
Manually

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

  • spring-cli-installer-<version>-1.x86_64.rpm - rpm 安装程序，附带 x86 JDK

  • spring-cli-installer<version>-1_amd64.deb_ - dep 安装程序，附带 x86 JDK

Homebrew Tap
brew tap spring-cli-projects/spring-cli
brew install spring-cli
Mac
Manually

  • spring-cli-standalone-<version>-osx.x86_64.zip - 捆绑 x86 JDK

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

Homebrew Tap

The Tap formula chooses between x86 and aarch64, depending on your brew setup.

brew tap spring-cli-projects/spring-cli
brew install spring-cli
Generic
Manually

  • spring-cli-<version>.jar - 纯 fat jar 文件，需要单独安装 JDK17

  • spring-cli-<version>.zip - 纯 fat jar 文件，带有启动脚本，需要单独安装 JDK17

Getting Snapshot Binaries

可在 GitHub Releases early-access 中获得最新的快照二进制文件。

您也可以按照[本页后面内容中所述的安装构建说明]根据源代码构建 Uber-jar。

Building from source

Java 17 Installation Required

即使您在 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 所需的。

Build Instructions

若要自己构建 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-{project-version}.jar'

Interactive Mode

除了使用别名运行 Spring Boot Uber-jar 或使用命令行上的“spring”运行原生二进制文件外，还可以进入交互模式，其中 Spring CLI 将继续运行。在这种情况下，您无需添加“spring”关键字即可运行命令。

交互模式提供命令选项完成功能，但您也可以依赖于位置选项值。

Command Completion

在非交互模式下，可以通过运行以下命令来在 shell 中获取命令完成：

eval "$(java -jar $HOME/temp/spring-cli/build/libs/spring-cli-{project-version}.jar completion bash)"

如果您配置了[role="bare"]https://docs.brew.sh/Shell-Completion，则 Homebrew 公式将设置 bash 自动完成。

Getting Help

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

若要获取有关特定命令的帮助，请输入 spring help 以及命令和子命令名称，例如 spring help boot new。