摘要：安裝可以與經(jīng)典開發(fā)工具一起使用，也可以作為命令行工具安裝。下面的示例展示了一個(gè)典型的文件安裝命令行接口是一個(gè)命令行工具，你可以使用它來快速地實(shí)現(xiàn)的原型。

Spring Boot可以與“經(jīng)典”Java開發(fā)工具一起使用，也可以作為命令行工具安裝。無論哪種方式，都需要Java SDK v1.8或更高版本。在開始之前，你應(yīng)該使用以下命令檢查當(dāng)前的Java安裝：

$ java -version

如果你是Java開發(fā)新手，或者你想嘗試使用Spring Boot，那么你可能想先嘗試一下Spring Boot CLI（命令行接口）。否則，請(qǐng)繼續(xù)閱讀“經(jīng)典”安裝說明。

你可以使用與任何標(biāo)準(zhǔn)Java庫相同的方式使用Spring Boot，為此，在類路徑上包括適當(dāng)?shù)?b>spring-boot-*.jar文件。Spring Boot不需要任何特殊的工具集成，因此你可以使用任何IDE或文本編輯器。另外，Spring Boot應(yīng)用程序沒有什么特別之處，因此你可以像其他Java程序一樣運(yùn)行和調(diào)試Spring Boot 應(yīng)用程序。

盡管你可以復(fù)制Spring Boot jar，但是我們通常建議你使用一個(gè)支持依賴管理的構(gòu)建工具（比如Maven或Gradle）。

Spring Boot與Apache Maven 3.2或以上兼容，如果你沒有安裝Maven，則可以按照maven.apache.org的指示執(zhí)行。

在許多操作系統(tǒng)中，可以使用安裝包安裝Maven。如果你使用OSX Homebrew，嘗試brew install maven，Ubuntu用戶可以運(yùn)行sudo apt-get install maven。使用Chocolatey的Windows用戶可以從一個(gè)高級(jí)（管理員）提示符中運(yùn)行choco install maven。

Spring boot依賴使用org.springframework.boot groupId，通常Maven POM文件從spring-boot-starter-parent項(xiàng)目繼承，并向一個(gè)或多個(gè)“starter”聲明依賴關(guān)系，Spring Boot還提供了一個(gè)可選的Maven插件來創(chuàng)建可執(zhí)行的jar。

下面的清單顯示了一個(gè)典型的pom.xml文件:

     
  4.0.0
  com.example
  myproject 
  0.0.1-SNAPSHOT
  
   
    org.springframework.boot 
    spring-boot-starter-parent                                       
    2.0.5.RELEASE
  
  
  
    
      org.springframework.boot
      spring-boot-starter-web 
    
  
  
  
   
      
       org.springframework.boot 
       spring-boot-maven-plugin
     
   
  

Spring-Boot-starter-parent是一個(gè)使用Spring boot的好方法，但是它可能不適合所有，有時(shí)你可能需要從另一個(gè)父POM繼承，或者你可能不喜歡我們的默認(rèn)設(shè)置。在這些情況下，請(qǐng)參見“13.2.2章節(jié)，使用沒有父POM的Spring Boot”，以尋找使用import范圍的替代解決方案。

Spring Boot與Gradle 4兼容，如果你還沒有安裝Gradle，你可以按照gradle.org上的說明進(jìn)行操作。

Spring Boot依賴項(xiàng)可以通過使用org.springframework.boot group來聲明。通常，你的項(xiàng)目聲明依賴于一個(gè)或多個(gè)“Starters”，Spring Boot提供了一個(gè)有用的Gradle插件，它可以用來簡(jiǎn)化依賴項(xiàng)聲明并創(chuàng)建可執(zhí)行的jar。

Gradle Wrapper
當(dāng)你需要構(gòu)建一個(gè)項(xiàng)目時(shí)，Gradle Wrapper提供了一種“獲取”Gradle的好方法。它是一個(gè)小腳本和庫，你可以將其與代碼一起提交以引導(dǎo)構(gòu)建過程。有關(guān)詳細(xì)信息，請(qǐng)參閱docs.gradle.org/4.2.1/userguide/gradle_wrapper.html。

下面的示例展示了一個(gè)典型的build.gradle文件:

plugins {
 id "org.springframework.boot" version "2.0.5.RELEASE" 
 id "java"
}


jar {
 baseName = "myproject" 
 version = "0.0.1-SNAPSHOT"
}

repositories {
 jcenter()
}

dependencies { 
 compile("org.springframework.boot:spring-boot-starter-web")   
 testCompile("org.springframework.boot:spring-boot-starter-test")
}

Spring Boot CLI（命令行接口）是一個(gè)命令行工具，你可以使用它來快速地實(shí)現(xiàn)Spring的原型。它允許你運(yùn)行Groovy腳本，這意味著你有一個(gè)熟悉的類似java語法，沒有太多的樣板代碼。

你不需要使用CLI來使用Spring Boot，但是這絕對(duì)是使Spring應(yīng)用程序啟動(dòng)的最快方法。

你可以從Spring軟件存儲(chǔ)庫下載Spring CLI發(fā)行版：

spring-boot-cli-2.0.5.RELEASE-bin.zip

spring-boot-cli-2.0.5.RELEASE-bin.tar.gz

也可以使用快照版snapshot distributions

下載后，按照未壓縮的文檔中INSTALL.txt介紹進(jìn)行?？傊?，在.zip文件中的bin/目錄中有一個(gè)spring腳本(windows spring.bat)?；蛘撸憧梢允褂?b>java -jar運(yùn)行.jar文件(腳本可以幫助你確定類路徑是否正確設(shè)置)。

SDKMAN!（軟件開發(fā)工具包管理器）可以用于管理各種二進(jìn)制SDK的多個(gè)版本，包括Groovy和Spring Boot CLI。從sdkman.io獲取SDKMAN!，安裝Spring Boot使用以下命令:

$ sdk install springboot
$ spring --version
Spring Boot v2.0.5.RELEASE

如果你為CLI開發(fā)了特性，并希望輕松訪問你構(gòu)建的版本，請(qǐng)使用以下命令：

$ sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-2.0.5.RELEASE-bin/spring-2.0.5.RELEASE/
$ sdk default springboot dev
$ spring --version
Spring CLI v2.0.5.RELEASE

前面的指令安裝了一個(gè)spring名為dev實(shí)例的本地實(shí)例。它指向你的目標(biāo)構(gòu)建位置，因此每當(dāng)你重新構(gòu)建Spring Boot時(shí)，spring都是最新的。

你可以通過運(yùn)行以下命令來查看：

$ sdk ls springboot

================================================================================
Available Springboot Versions
================================================================================
> + dev
* 2.0.5.RELEASE

================================================================================
+ - local version
* - installed
> - currently in use
================================================================================

如果你在Mac上使用Homebrew，你可以使用以下命令來安裝Spring Boot CLI：

$ brew tap pivotal/tap
$ brew install springboot

Homebrew安裝spring到/usr/local/bin目錄下。

如果沒有看到公式，brew的安裝可能已經(jīng)過時(shí)，在這種情況下，運(yùn)行brew update并再次嘗試。

如果你在Mac上并使用MacPorts，你可以使用以下命令來安裝Spring Boot CLI:

$ sudo port install spring-boot-cli

Spring Boot CLI包括為BASH和zsh shell提供命令實(shí)現(xiàn)的腳本，你可以在任何shell中source腳本(也稱為spring)，或者將其放入你的個(gè)人或系統(tǒng)范圍的bash實(shí)現(xiàn)初始化中。在Debian系統(tǒng)中，系統(tǒng)范圍的腳本在/shell-completeion/bash中，在新shell啟動(dòng)時(shí)將執(zhí)行該目錄中的所有腳本。例如，如果你已經(jīng)安裝了SDKMAN!，就可以手動(dòng)運(yùn)行腳本，使用以下命令:

$ . ~/.sdkman/candidates/springboot/current/shell-completion/bash/spring
$ spring 
  grab  help  jar  run  test  version

如果你使用Homebrew或MacPorts安裝Spring Boot CLI，命令行實(shí)現(xiàn)腳本會(huì)自動(dòng)注冊(cè)到你的shell中。

如果你在Windows上使用Scoop命令，你可以使用以下命令來安裝Spring Boot CLI：

> scoop bucket add extras
> scoop install springboot

Scoop安裝spring到~/scoop/apps/springboot/current/bin。

你可以使用以下web應(yīng)用程序來測(cè)試你的安裝，首先，創(chuàng)建一個(gè)名為app.groovy的文件，如下所示:

@RestController
class ThisWillActuallyRun {

  @RequestMapping("/")
  String home() {
    "Hello World!"
  }
 
}

然后從shell運(yùn)行它，如下:

$ spring run app.groovy

應(yīng)用程序第一次運(yùn)行速度很慢，因?yàn)橐蕾図?xiàng)被下載，后續(xù)的運(yùn)行要快得多。

在你最喜歡的web瀏覽器中打開localhost:8080，你應(yīng)該會(huì)看到以下輸出:

Hello World!

如果你正在從更早的Spring Boot版本升級(jí)，請(qǐng)檢查項(xiàng)目wiki上提供詳細(xì)的升級(jí)說明的“遷移指南”，還要檢查“發(fā)布說明”，以獲得每個(gè)版本的“新的和需要注意的”特性。

當(dāng)升級(jí)到新特性版本時(shí)，一些屬性可能已經(jīng)被重命名或刪除，Spring Boot提供了一種在啟動(dòng)時(shí)分析應(yīng)用程序環(huán)境和打印診斷信息的方法，還為你在運(yùn)行時(shí)臨時(shí)遷移屬性，要啟用該特性，請(qǐng)向項(xiàng)目添加以下依賴項(xiàng)：

    org.springframework.boot
    spring-boot-properties-migrator
    runtime

在環(huán)境中添加較晚的屬性（比如在使用@PropertySource時(shí)）將不被考慮。

完成遷移后，請(qǐng)確保將此模塊從項(xiàng)目的依賴項(xiàng)中刪除。

要升級(jí)現(xiàn)有的CLI安裝，請(qǐng)使用適當(dāng)?shù)陌芾砥髅睿ɡ纾?b>brew upgrade），或者，如果你手動(dòng)安裝CLI，請(qǐng)遵循標(biāo)準(zhǔn)說明，記住更新PATH環(huán)境變量以刪除任何舊的引用。