sbtでPlay Frameworkプロジェクトをビルド・実行する方法を初心者向け解説

1. sbtを使ってプロジェクトをビルドする準備

1. sbtを使ってプロジェクトをビルドする準備

Play Framework を動かすためには、まず開発の土台となる sbt が正しくインストールされている必要があります。 sbt は「プロジェクトのビルド・依存関係の取得・アプリの起動」などをまとめて行ってくれる便利なツールで、 これがないと Play のプロジェクトは動かせません。 そのため、最初のステップとして sbt が使える状態になっているか確認することがとても重要です。

まずは、以下のコマンドをターミナル（コマンドプロンプト）に入力して、 ちゃんと sbt のバージョンが表示されるか確認しましょう。

sbt sbtVersion

ここでバージョン番号が表示されれば準備は完了です。 もし「コマンドが見つかりません」といったエラーが出る場合は、 まだ sbt がインストールされていない、または PATH の設定が通っていない可能性があります。 その場合は sbt 公式サイトから最新版をダウンロードしてインストールしておきましょう。

> sbt sbtVersion
[info] welcome to sbt!
[info] sbt version in this project: 1.9.7
[info] sbt version in global scope: 1.9.7

2. プロジェクトディレクトリに移動

2. プロジェクトディレクトリに移動

次に、Play Frameworkのプロジェクトディレクトリに移動します。公式サンプルの場合は、以下のようにします。

cd play-samples/play-java-hello-world

ここで、sbtを使ってビルドや実行ができる準備が整いました。

3. プロジェクトをビルドする方法

3. プロジェクトをビルドする方法

プロジェクトをビルドするとは、コードをコンパイルして実行可能な状態にすることです。sbtでは次のコマンドを入力します。

sbt compile

コンパイルが成功すると、依存関係も解決され、コードが正しくビルドされたことを確認できます。

4. アプリケーションを実行する方法

4. アプリケーションを実行する方法

ビルドが終わったら、次はアプリケーションを起動します。sbtで次のコマンドを入力します。

sbt run

このコマンドを実行すると、Play Frameworkのサーバーが起動し、コンソールに「Server started at http://localhost:9000」と表示されます。これでブラウザからアプリにアクセスできます。

5. ブラウザで動作確認

5. ブラウザで動作確認

サーバーが起動したら、ブラウザで http://localhost:9000 にアクセスします。公式サンプルの「Hello World」が表示されれば、無事に実行できています。

6. sbtの便利なコマンド

6. sbtの便利なコマンド

sbtには開発を効率化する便利なコマンドがあります。

• compile : プロジェクトをコンパイルしてビルド
• run : アプリケーションを起動
• test : ユニットテストを実行
• clean : ビルドの成果物を削除して再ビルド準備

これらを覚えておくと、Play Frameworkの開発がスムーズになります。

7. よくあるトラブルと対処方法

7. よくあるトラブルと対処方法

sbtでプロジェクトをビルド・実行する際によくあるトラブルと対処法です。

• Javaのバージョンが古い → JDK 11以上をインストール
• ポート9000が使用中 → sbt run時に別ポート指定 sbt "run 9001"
• 依存ライブラリが取得できない → ネットワーク環境を確認し再実行
• コンパイルエラーが出る → コードを見直し、必要なら clean して再ビルド

8. sbtを活用して効率よく開発する

8. sbtを活用して効率よく開発する

公式サンプルを動かした後は、sbtの機能を活用して効率よく開発できます。自動コンパイルやホットリロード機能を使えば、コードを変更するたびにサーバーを再起動する必要がなく、ブラウザで即座に確認できます。これにより、Play FrameworkでのWebアプリ開発をスムーズに進めることができます。

まとめ

まとめ

今回の記事では、Play Frameworkのプロジェクトをsbtでビルドして実行する一連の流れを初心者向けに整理しながら学びました。とくにsbtというツールがどのようにPlay Frameworkの基盤を支え、ビルドや依存関係の解決、アプリケーションの起動などを自動化してくれるのかを理解することで、Webアプリケーション開発に必要な基礎操作が自然に身についていきます。

sbtの基本的なコマンドであるcompile、run、test、cleanを覚えれば、Play Frameworkの開発効率は一段と向上します。初心者にとって難しく感じる部分も、コマンドを順に実行しながら確かめることで少しずつ理解できるようになります。また、sbtが依存ライブラリを自動で取得してくれるため、煩雑な設定を意識せずに開発を進められるのも大きな魅力です。

さらに、プロジェクトディレクトリへ移動してからビルドし、実行後にブラウザから http://localhost:9000 にアクセスする流れを体験することで、Play Frameworkの仕組みが一気に分かりやすくなります。実際に画面が表示されることで、コードがどのように動作しているのかが目に見えて理解でき、初心者でも安心して開発を続けられるようになります。

この記事の内容をもとに、自分の環境で試しながら学習を進めれば、sbtとPlay Frameworkの連携は確実に身につきます。ここでは、振り返りとしてサンプルコマンドや簡単なコントローラのコード例を再掲し、初心者がつまずきやすい点を整理します。

Play Frameworkを起動するサンプルコマンド

# sbtのバージョンを確認
sbt sbtVersion

# プロジェクトのコンパイル
sbt compile

# アプリケーションを起動
sbt run

簡単なコントローラのサンプルコード

package controllers

import javax.inject._
import play.api.mvc._

@Singleton
class SampleController @Inject()(val controllerComponents: ControllerComponents) extends BaseController {

    def hello() = Action { implicit request: Request[AnyContent] =>
        Ok("sbtで起動したPlay Frameworkアプリからのメッセージです")
    }
}

ルーティング設定も一緒に確認

GET     /hello          controllers.SampleController.hello

上記のように、コントローラとルーティングを追加するだけで、sbtでビルドしたアプリから任意のメッセージを表示できます。この仕組みを理解すれば、画面を増やしたり、新しい処理を追加したりといった応用もスムーズに進められるようになります。自動コンパイルやホットリロード機能も活かすことで、再起動の手間を省きながら効率よく開発できる点も魅力です。

また、よくあるトラブルとして挙げたJavaバージョンの不一致や依存関係エラー、ポートの競合などに注意しながら作業することで、より安定して開発が行えます。sbtは強力なツールですが、正しく扱えば初心者の強い味方になります。今回学んだ知識を積み重ねていけば、Play FrameworkでのWebアプリケーション開発の土台がしっかり築かれるはずです。