Spring Boot のインストール

Eclipse STS、IntelliJ IDEA、VSCode Auto Config を使用する場合、以降に示すインストール手順は不要です。Spring Initializr クイックスタートや簡単な Web 画面の作成を試してみてください。コマンドラインを使用する場合は、次のコマンドを使用して現在インストールされている Java を確認する必要があります。

$ java -version

コマンドラインで開発する場合は、以降の手順に従ってください。

Java 開発者向けのインストール手順

Spring Boot は特別なツールの統合を必要としないため、クラスパスに適切な spring-boot-*.jar ファイルを含めることで、標準 Java ライブラリと同じ方法で使用できます。また、Spring Boot アプリケーションには特別なものはないため、他の Java プログラムと同様に Spring Boot アプリケーションを実行およびデバッグできます。

Spring Boot の jar を手動でダウンロードしてプロジェクト内に配置することもできますが、依存性管理が困難になるため、通常はサポートするビルドツール（Gradle や Maven など）を使用することをお勧めします。Eclipse STS や IntelliJ IDEA のような IDE の場合は Gradle や Maven が含まれているため、IDE 付属のデフォルトのバージョンを使用する場合は、後述の Gradle や Maven のインストール不要です。また、異なるバージョンが必要な場合でも、Spring Initializr で作成した Spring Boot プロジェクトには gradlew や mvnw が含まれているため、Gradle や Maven のインストールは必要ありません。

Maven のインストール

Spring Boot は Apache Maven 3.6.3 以降と互換性があります。Maven をまだインストールしていない場合は、maven.apache.org (英語) の手順に従ってください。

多くのオペレーティングシステムでは、Maven はパッケージマネージャーを使用してインストールできます。OSX Homebrew を使用する場合は、brew install maven を試してください。Ubuntu ユーザーは sudo apt-get install maven を実行できます。Chocolatey (英語) を使用する Windows ユーザーは、昇格した（管理者）プロンプトから choco install maven を実行できます。

Spring Boot 依存関係は org.springframework.boot グループ ID を使用します。通常、Maven POM ファイルは spring-boot-starter-parent プロジェクトから継承し、1 つ以上の “スターター” への依存関係を宣言します。Spring Boot は、実行可能な jar を作成するためのオプションの Maven プラグインも提供します。

Spring Boot と Maven の使用開始の詳細については、Maven プラグインのリファレンスガイドの入門セクションを参照してください。

Gradle のインストール

Spring Boot は Gradle 7.x(7.5 以降)、8.x と互換性があります。Gradle をまだインストールしていない場合は、gradle.org (英語) の指示に従ってください。

Spring Boot の依存関係は、org.springframework.bootgroup を使用して宣言できます。通常、プロジェクトは 1 つ以上の “スターター” への依存関係を宣言します。Spring Boot は、依存関係の宣言を簡素化し、実行可能な jar を作成するために使用できる便利な Gradle プラグインを提供します。

Gradle ラッパー

Gradle ラッパーは、プロジェクトをビルドする必要がある場合に Gradle を「取得」する優れた方法を提供します。これは、ビルドプロセスをブートストラップするためにコードと一緒にコミットする小さなスクリプトとライブラリです。詳細については、docs.gradle.org/current/userguide/gradle_wrapper.html (英語) を参照してください。

Spring Boot と Gradle の使用開始の詳細については、Gradle プラグインのリファレンスガイドの入門セクションを参照してください。

Spring Boot CLI のインストール

Spring Boot CLI (コマンドラインインターフェース) は、Spring ですばやくプロトタイプを作成するために使用できるコマンドラインツールです。

Spring Boot を操作するために CLI を使用する必要はありませんが、Eclipse STS や IntelliJ IDEA のような IDE を使用せずに Spring アプリケーションをすぐに使用できるようにする方法です。

手動インストール

Spring CLI ディストリビューションは、次のいずれかの場所からダウンロードできます。

ダウンロードしたら、解凍したアーカイブの INSTALL.txt (英語) の指示に従ってください。要約すると、.zip ファイルの bin/ ディレクトリには、spring スクリプト（Windows の場合は spring.bat）があります。または、.jar ファイルで java -jar を使用できます（スクリプトは、クラスパスが正しく設定されていることを確認できます）。

SDKMAN! を使用したインストール

SDKMAN!（Software Development Kit Manager）は、Groovy や Spring Boot CLI など、さまざまなバイナリ SDK の複数のバージョンを管理するために使用できます。sdkman.io (英語) から SDKMAN! を取得し、次のコマンドを使用して Spring Boot をインストールします。

$ sdk install springboot
$ spring --version
Spring CLI v3.3.1

CLI の機能を開発し、ビルドしたバージョンにアクセスする場合は、次のコマンドを使用します。

$ sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-3.3.1-bin/spring-3.3.1/
$ sdk default springboot dev
$ spring --version
Spring CLI v3.3.1

上記の手順では、dev インスタンスと呼ばれる spring のローカルインスタンスをインストールします。ターゲットビルドの場所を指すため、Spring Boot を再構築するたびに、spring は最新の状態になります。

次のコマンドを実行して確認できます。

$ sdk ls springboot

================================================================================
Available Springboot Versions
================================================================================
> + dev
* 3.3.1

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

OSX Homebrew のインストール

Mac で Homebrew (英語) を使用している場合、次のコマンドを使用して Spring Boot CLI をインストールできます。

$ brew tap spring-io/tap
$ brew install spring-boot

Homebrew は /usr/local/bin に spring をインストールします。

formula が表示されない場合、brew のインストールが古くなっている可能性があります。その場合は、brew update を実行して再試行してください。

MacPorts のインストール

Mac で MacPorts (英語) を使用している場合、次のコマンドを使用して Spring Boot CLI をインストールできます。

$ sudo port install spring-boot-cli

コマンドライン補完

Spring Boot CLI には、BASH [Wikipedia] および zsh [Wikipedia] シェルのコマンド補完を提供するスクリプトが含まれています。任意のシェルでスクリプト（spring とも呼ばれる）を source するか、個人またはシステム全体の bash 完了初期化に配置できます。Debian システムでは、システム全体のスクリプトは <installation location>/shell-completion/bash にあり、そのディレクトリ内のすべてのスクリプトは、新しいシェルの起動時に実行されます。例: SDKMAN! を使用してインストールした場合にスクリプトを手動で実行するには、次のコマンドを使用します。

$ . ~/.sdkman/candidates/springboot/current/shell-completion/bash/spring
$ spring <HIT TAB HERE>
  grab  help  jar  run  test  version

Homebrew または MacPorts を使用して Spring Boot CLI をインストールすると、コマンドライン補完スクリプトがシェルに自動的に登録されます。

Windows Scoop のインストール

Windows で Scoop (英語) を使用している場合、次のコマンドを使用して Spring Boot CLI をインストールできます。

$ scoop bucket add extras
$ scoop install springboot

Scoop は ~/scoop/apps/springboot/current/bin に spring をインストールします。

アプリのマニフェストが表示されない場合は、scoop のインストールが古くなっている可能性があります。その場合は、scoop update を実行して再試行してください。