SDKMANでMicronautをインストールする方法！Java環境の切り替えもやさしく解説

1. SDKMANをインストールする

1. SDKMANをインストールする

SDKMAN!（Software Development Kit Manager）は、JavaやMicronautなどの開発ツールをコマンド一つでインストール・管理できる非常に便利なツールです。 特に「プロジェクトごとにJavaのバージョンを変えたい」といった複雑な設定も、SDKMANを使えば初心者でも一瞬で切り替えが可能になります。

まずは、お使いのターミナル（MacのターミナルやLinuxのシェル）を開き、以下のコマンドを順番にコピー＆ペーストして実行してみましょう。

# 手順1: SDKMANのインストールスクリプトを実行
$ curl -s "https://get.sdkman.io" | bash

# 手順2: 設定を反映させる（現在のターミナルでSDKMANを使えるようにする）
$ source "$HOME/.sdkman/bin/sdkman-init.sh"

# 手順3: 正しくインストールされたか確認
$ sdk version

この手順でSDKMANが正しくセットアップされると、複雑な環境構築に悩まされることなく、スムーズにJavaやMicronautの学習をスタートさせることができます。

2. Javaのバージョンをインストールして切り替える

2. Javaのバージョンをインストールして切り替える

MicronautはJavaで動作するので、まずJavaをSDKMANでインストールします。例えばJava 17をインストールする場合は次のコマンドです。

$ sdk install java 17.0.8-tem
$ sdk use java 17.0.8-tem
$ java -version

複数のJavaバージョンをインストールしておき、プロジェクトに応じて切り替えられるので、開発効率が高まります。

3. Micronaut CLIのインストール

3. Micronaut CLIのインストール

次にMicronaut CLIをSDKMANでインストールします。CLIを使うとプロジェクト作成やビルド、依存管理が簡単になります。

$ sdk install micronaut
$ mn --version

CLIのバージョン確認でインストールが正しく行われたか確認できます。これでMicronaut開発環境の準備は整いました。

4. Micronautプロジェクトの作成

4. Micronautプロジェクトの作成

Micronaut CLIを使えば、新しいプロジェクトも簡単に作成できます。以下のコマンドでGradleビルドのJavaプロジェクトを作成してみましょう。

$ mn create-app example.micronaut.cli --build=gradle --lang=java

ディレクトリ構成や基本設定ファイルが自動生成され、すぐに開発を開始できます。

5. 簡単なコントローラを作って動作確認

5. 簡単なコントローラを作って動作確認

作成したプロジェクトで簡単なコントローラを追加して、Micronaut環境が正しく動作するか確認します。

import io.micronaut.runtime.Micronaut;
import io.micronaut.http.annotation.*;

@Controller("/hello")
class HelloController {

    @Get("/")
    public String index() {
        return "Hello, Micronaut with SDKMAN!";
    }
}

public class Application {
    public static void main(String[] args) {
        Micronaut.run(Application.class);
    }
}

ブラウザでhttp://localhost:8080/helloにアクセスすると、「Hello, Micronaut with SDKMAN!」と表示されます。これでSDKMANを使ったMicronaut開発環境の確認が完了です。

6. 学習の進め方のポイント

6. 学習の進め方のポイント

SDKMANで環境を整えたら、次はMicronautの基本構造、コントローラ作成、サービス注入、ルーティング、設定管理などを学ぶと、実務レベルでの開発にスムーズに進めます。バージョン切り替えを活用して複数プロジェクトの管理にも慣れておくと便利です。

まとめ

まとめ

SDKMANとMicronautを活用した開発環境づくりの総整理

SDKMANを利用したMicronaut開発環境の構築は、Javaのバージョン管理やMicronaut CLIのインストールが直感的に行えるため、初学者にとって非常に扱いやすい流れになります。特にJava環境を複数使い分ける必要がある場面では、SDKMANの切り替え機能が大きな力を発揮し、開発プロジェクトごとに最適な環境を整えることができます。この記事で学んだ基本的なコマンド操作やインストール手順を身につけておくことで、Micronautを活用したアプリケーション開発の基礎を確実に固めることができ、より安定した開発体験が得られます。 また、Micronaut CLIを使ったプロジェクト作成は、必要なファイル構成やビルド設定が自動生成されるため、初心者でも複雑な設定を理解しながら進められるのが大きな特徴です。CLIによって生成されるGradleプロジェクトは、依存関係の管理、ビルド、テストなどが整えられ、学習の最初のステップとして非常に効果的です。Java環境をSDKMANで操作しながらMicronautを扱うことで、環境構築の柔軟性とMicronautの軽量性をどちらも理解できる良い機会になります。 さらに、環境構築後のコントローラ作成では、Micronautが提供するアノテーションを用いたシンプルな実装と高速なレスポンスの確認ができ、実際のアプリケーション開発の流れを自然に掴むことができます。手順通りに動作確認を行うことで、自分の作成したアプリケーションが正しく動いているという実感を得られ、学習のモチベーション向上にもつながります。 今後、より高度な機能を扱う際にも、SDKMANで整えたJavaとMicronautの環境がしっかりしていれば安心して進めることができ、複数プロジェクトの運用やバージョン互換性の確認もスムーズに行えるようになります。環境構築の土台が整うことで、設定管理、各種サービスの注入、ルーティングの finer control など、より深い学習へ自然にステップアップできます。

MicronautとSDKMANの連携を確かめるサンプル設定

記事の内容を踏まえて、環境確認としてGradleの設定例を以下にまとめます。この設定例はMicronaut CLIによって生成されるファイルに近い形式で、依存管理やビルド処理の流れを理解する助けになります。

plugins {
    id "java"
    id "io.micronaut.application" version "4.0.0"
}

micronaut {
    runtime "netty"
    testRuntime "junit5"
    processing {
        incremental true
        annotations "example.micronaut.cli.*"
    }
}

dependencies {
    implementation("io.micronaut:micronaut-http-client")
    implementation("io.micronaut:micronaut-runtime")
    implementation("io.micronaut.validation:micronaut-validation")
}

上記の設定では、MicronautのランタイムやHTTPクライアント、バリデーションなどの機能をプロジェクトに追加しています。開発を続ける中で必要な依存関係を適切に追加していくことで、より強力なアプリケーションを構築することができます。SDKMANが提供する柔軟なバージョン管理とMicronautの高速なアーキテクチャが組み合わさることで、複数プロジェクト開発にも対応しやすい安定した開発環境が実現します。 また、Micronaut CLIによる操作に慣れてくると、アプリケーション作成、テスト、ビルドを一貫して扱えるようになり、開発サイクルを短縮しながら品質の高いコードを書くことが可能になります。Javaのバージョン切り替えを行いながら、各プロジェクトの要件に最適な設定を使い分けるという技術も自然と身につき、より実践的な視点でMicronautの理解が深まります。