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. SDKMAN!を使ったJavaのインストールとバージョン切り替え

2. SDKMAN!を使ったJavaのインストールとバージョン切り替え

Micronautでアプリケーションを開発するには、まず土台となるJava（JDK）が必要です。ここでは、エンジニアの間で標準的に使われている「SDKMAN!」というツールを使って、簡単にJavaを準備する方法を解説します。

例えば、LTS（長期サポート）版であるJava 17をインストールして有効化するには、ターミナルで以下のコマンドを入力します。

# 指定したバージョンのJavaをダウンロードしてインストール
$ sdk install java 17.0.10-tem

# 現在のセッションで使用するJavaのバージョンを指定
$ sdk use java 17.0.10-tem

# 正しく設定されたか確認（バージョン情報が表示されればOK！）
$ java -version

インストールが完了したら、簡単なJavaプログラムを動かしてみましょう。以下のコードは、あなたのPCでJavaが正常に動作しているかを確認するための最もシンプルなサンプルです。

public class HelloJava {
    public static void main(String[] args) {
        // 画面にメッセージを表示する命令です
        System.out.println("Javaのセットアップが完了しました！");
    }
}

このように、プロジェクトの要求に合わせて最適なJava環境を整えることが、Micronaut開発をスムーズに進めるための第一歩となります。SDKMAN!を使いこなして、効率的な開発環境を構築しましょう。

3. Micronaut CLIのインストールと基本操作

3. Micronaut CLIのインストールと基本操作

Javaのフレームワークを効率よく扱うために欠かせないのが、コマンド操作を助けてくれるMicronaut CLI（コマンドラインインターフェース）です。これを使うことで、複雑な設定ファイルを自分で書くことなく、初心者でもコマンド一つでプロジェクトの雛形を自動生成できるようになります。

まずは、前のステップで導入したSDKMANを使って、最新のMicronaut CLIをインストールしましょう。ターミナル（またはコマンドプロンプト）で以下のコマンドを入力してください。

$ sdk install micronaut
$ mn --version

「Micronaut Version: X.X.X」のようにバージョンが表示されれば、インストールは無事成功です。もしエラーが出る場合は、ターミナルを一度閉じて再起動してみてください。

初心者に優しい「mn」コマンドのメリット

プログラミング未経験の方にとって、「黒い画面でコマンドを打つ」のは少し怖く感じるかもしれません。しかし、Micronaut CLI（mnコマンド）は、いわば「全自動の設計図作成ツール」です。例えば、以下のようなJavaの実行コードを、手動で一から書く必要はありません。

// CLIを使えば、このような起動用コードも自動で生成されます
package com.example;

import io.micronaut.runtime.Micronaut;

public class Application {
    public static void main(String[] args) {
        // この一行でサーバーが起動し、アプリが動くようになります
        Micronaut.run(Application.class, args);
    }
}

このように、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の理解が深まります。