1. sbtインストールの前提条件

sbtをインストールする前に、必ずJavaがインストールされている必要があります。Play FrameworkはJava仮想マシン上で動作するため、JDK（Java Development Kit）が必須です。一般的にはOpenJDKやAdoptium TemurinなどのJDKを利用すると安定して動作します。

インストール済みか確認するには、ターミナルやコマンドプロンプトで以下を入力します。


java -version

ここでJavaのバージョンが表示されれば準備完了です。もし「コマンドが見つかりません」と出る場合は、まずJavaをインストールしてください。

2. Windowsでのsbtインストール方法

Windowsでsbtをインストールする方法は大きく分けて2つあります。インストーラーを使う方法と、scoopやchocolateyといったパッケージマネージャーを使う方法です。初心者にはインストーラーを利用するのがおすすめです。

インストーラーを使った方法

sbt公式サイトにアクセスしてWindows用インストーラーをダウンロードする
インストーラーを実行して手順に従いインストールする
環境変数PATHにsbtのパスが自動で追加される

scoopを使った方法


scoop install sbt

chocolateyを使った方法


choco install sbt

これでWindows環境にsbtがインストールされます。正しくインストールできたか確認するには以下を入力します。


sbt sbtVersion

バージョンが表示されれば成功です。

3. Macでのsbtインストール方法

MacではHomebrewを使うのが一般的で最も簡単です。HomebrewはMac用のパッケージマネージャーで、多くの開発者が利用しています。

Homebrewを使った方法


brew install sbt

インストールが終わったら以下のコマンドで確認します。


sbt sbtVersion

もしHomebrewをまだインストールしていない場合は、公式サイトからインストールしてから実行してください。

4. Linuxでのsbtインストール方法

Linux環境ではディストリビューションごとにインストール方法が異なります。代表的なUbuntuとCentOSについて説明します。

Ubuntu / Debian系


echo "deb https://repo.scala-sbt.org/scalasbt/debian all main" | sudo tee /etc/apt/sources.list.d/sbt.list
curl -sL "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x99e82a75642ac823" | sudo apt-key add
sudo apt-get update
sudo apt-get install sbt

CentOS / Fedora系


curl -sL https://www.scala-sbt.org/sbt-rpm.repo | sudo tee /etc/yum.repos.d/sbt-rpm.repo
sudo yum install sbt

Linux環境でも同じく以下のコマンドで確認します。


sbt sbtVersion

5. sbtインストール後の動作確認とトラブルシューティング

sbtが正常にインストールされたかを確認するには、ターミナルまたはコマンドプロンプトでsbtと入力します。初回起動は依存ファイルのダウンロードが行われるため時間がかかりますが、これは正常です。

よくあるトラブルとしては、環境変数PATHが正しく設定されていないことがあります。その場合は、sbtのインストールディレクトリを手動でPATHに追加してください。

また、古いJavaバージョンが原因で起動しない場合もあるので、Play Frameworkに対応したJavaバージョンを利用することをおすすめします。

まとめ

sbtインストール手順とPlay Framework開発環境の全体像を振り返る

ここまでの記事では、Play Frameworkの開発環境を構築するうえで欠かせないsbtのインストール方法について、 Windows、Mac、Linuxそれぞれの環境に分けて丁寧に解説してきました。 sbtはScala Build Toolの略称ですが、Scala専用というわけではなく、 Play FrameworkのJavaプロジェクトでも標準的に利用される非常に重要なビルドツールです。 Play FrameworkでWebアプリケーション開発を始める際、sbtはプロジェクトの作成、依存関係の管理、アプリケーションの起動やテストの実行など、あらゆる場面で中心的な役割を果たします。

sbtを正しくインストールできていないと、Play Frameworkのプロジェクト自体が作成できなかったり、サーバーが起動しなかったりと、学習以前の段階でつまずいてしまいます。そのため、今回紹介したように、まずJavaがインストールされているかを確認し、その上でOSごとに適した方法でsbtを導入することがとても重要です。 Windowsでは公式インストーラーやscoop、chocolateyといった選択肢があり、 MacではHomebrewを使うことで簡単に導入できます。 LinuxでもUbuntu系やCentOS系など、ディストリビューションに合わせた手順を踏めば問題なくインストールできます。

また、sbtのインストール後にsbt sbtVersionやsbtコマンドで動作確認を行うことも、初心者が安心して次のステップへ進むために欠かせないポイントです。初回起動時に多くのファイルがダウンロードされるのは正常な挙動であり、ここで慌てずに待つことも大切な学習経験のひとつと言えるでしょう。環境変数PATHの設定やJavaのバージョン不一致といったトラブルもよく発生しますが、それらを一つひとつ確認しながら解決していくことで、 Webアプリケーション開発に必要な基礎的な知識が自然と身についていきます。

sbtのインストールが完了すると、いよいよPlay Frameworkのプロジェクト作成や、開発用サーバーの起動、コントローラやビューの実装といった本格的なWeb開発に進むことができます。 sbtは単なるインストール作業で終わるものではなく、今後も日常的に使い続ける開発ツールです。そのため、今回学んだインストール手順や基本的な確認方法は、 Play Frameworkを使ったJava Web開発を続けていくうえで、何度も役に立つ知識になります。