脱・手動管理！ SDKMAN で始めるモダン Java 開発環境： SDKMAN インストール と 効率化テクニックを紹介！

Java開発者の皆さん、こんにちは。日々の開発で、以下のような経験はないでしょうか？

「このプロジェクトはJava 8、あのプロジェクトはJava 17、そして新しい機能開発はJava 25で…」

複数のJavaバージョンを切り替えるたびに、環境変数を手動で設定し直したり、JAVA_HOMEが意図せず変わってビルドが失敗したり。
時には、特定の環境でのみ発生する問題に直面することもあるでしょう。

手動でのSDK管理は、開発効率の低下や、チーム全体の生産性、プロジェクトの安定性に悪影響を与える可能性があります。
現代の開発手法では、環境構築の複雑さが開発者の負担となり、本来の業務に集中しづらくなることがあります。

本記事では、Java開発におけるSDK管理の課題を解決し、開発環境を改善するツール「SDKMAN!」を紹介します。

SDKMAN!は、複雑なSDKのバージョン管理を簡素化し、効率的な開発環境の構築を支援します。
SDKMAN!を活用して、より快適なJava開発環境を実現しましょう！

目次

1. なぜ今、SDKMANなのか？
2. SDKMANとは？
3. SDKMANのインストール
   • macOS / Linux でのインストール
   • Windows (WSL2) でのセットアップ
   • アンインストール
   • インストール後の確認と初期設定
   • その他のインストール方法
     • カスタムロケーションへのインストール
     • CIモードでのインストール
4. シェルとの連携を強化する
   • Zsh/Oh My Zshでの補完機能の有効化
   • Fishシェルの設定
   • プロンプトに使用中のJavaバージョンを表示する
5. よく使う操作をエイリアスで高速化する
   • プロジェクトで使うJava/Maven/Gradleを一発で切り替えるエイリアス
   • 最新のLTSバージョンを素早くインストールするエイリアス
6. まとめ：快適なJava開発環境への第一歩

対象読者

• 複数のJavaプロジェクトを掛け持ちしており、SDKのバージョン管理に課題を感じている開発者
• JAVA_HOME の設定や切り替えに手間取っているJava開発者
• 開発環境のセットアップを効率化したいと考えている方
• SDKMAN! の導入を検討している、またはSDKMAN! の基本的な使い方を知りたい方

動作検証環境

この記事は、以下の環境で検証しています。

• OS : macOS Tahoe Version 26.0
• ハードウェア : MacBook Air 2024 M3 24GB
• Multipass : Multipass version 1.16.1
• Ubuntu : 24.0.4.0.2

1. なぜ今、SDKMANなのか？

プロジェクトごとに異なるJavaバージョンを使う現実

現代のソフトウェア開発では、モノリシックなアプリケーションだけでなく、マイクロサービスアーキテクチャも主流となりつつあり、様々な技術スタックが混在することが一般的です。

これにより、一つの開発者が複数のプロジェクトに携わり、それぞれのプロジェクトで異なるJavaバージョンやビルドツールを要求されるケースが頻繁に発生します。

例えば、レガシーなシステムはJava 8で稼働しているが、新規開発はJava 21で行う、といった状況は珍しくありません。

このような状況でSDKMAN!がなければ、開発者はバージョン切り替えのたびに多大な労力と時間を費やすことになります。

2. SDKMANとは？

SDKMAN!（The SDK Manager）は、JVM（Java Virtual Machine）上で動作する様々なSDK（Software Development Kit）を、コマンドラインから簡単にインストール、切り替え、管理できるツールです。

Java、Kotlin、Groovy、Scalaといった言語のSDKはもちろん、Maven、Gradle、Antなどのビルドツール、Spring Boot CLIなどのフレームワークCLIツールまで、幅広いSDKに対応しています。

SDKMAN!を導入することで、SDKのバージョン管理にかかる手間を削減し、アプリケーション開発に集中できるようになります。

Homebrewや手動管理との比較

SDKの管理方法として、Homebrewのようなパッケージマネージャーや、手動でのダウンロード・設定も考えられます。しかし、これらにはSDKMAN!にはない課題があります。

• Homebrew:
  • 確かに多くのSDKをインストールできますが、バージョン間の切り替えは手動でのリンク変更や環境変数の設定が必要となり、煩雑です。
  • また、Homebrewで提供されていない特定のバージョンやディストリビューション（例: Zulu OpenJDKの特定バージョン）の管理は困難です。
• 手動管理:
  • 各SDKの公式サイトからダウンロードし、パスを通す方法は最も原始的ですが、複数のバージョンを管理するとなると、ディレクトリ構造の整理、環境変数の設定、そして何よりも「今、どのバージョンがアクティブなのか」を常に意識し続ける必要があります。
  • これはヒューマンエラーの温床となりがちです。

SDKMAN!は、これらの課題を効率的に解決し、開発者がSDKのバージョン管理に費やす労力を軽減します。

3. SDKMANのインストール

SDKMAN!の導入は非常に簡単です。ここでは、macOS/LinuxとWindows (WSL2) でのインストール方法をご紹介します。

macOS / Linux でのインストール

macOSやLinux環境では、以下のコマンドをターミナルで実行するだけでSDKMAN!をインストールできます。

curl -s "https://get.sdkman.io" | bash

curl -s "https://get.sdkman.io" | bash

注意点: 上記コマンドを実行する前に、unzip および zip コマンドがシステムにインストールされていることを確認してください。もしインストールされていない場合、以下のようなエラーが表示され、インストールが中断されます。

Looking for unzip...
Not found.
======================================================================================================
 Please install unzip on your system using your favourite package manager.

 Restart after installing unzip.
======================================================================================================

Looking for unzip...
Not found.
======================================================================================================
 Please install unzip on your system using your favourite package manager.

 Restart after installing unzip.
======================================================================================================

または

Looking for zip...
Not found.
======================================================================================================
 Please install zip on your system using your favourite package manager.

 Restart after installing zip.
======================================================================================================

Looking for zip...
Not found.
======================================================================================================
 Please install zip on your system using your favourite package manager.

 Restart after installing zip.
======================================================================================================

unzip または zip がインストールされていない場合は、お使いのパッケージマネージャーでインストールしてください。例えば、Ubuntu/Debian系のシステムでは以下のコマンドでインストールできます。

sudo apt install unzip zip

sudo apt install unzip zip

unzip および zip のインストールが完了したら、再度SDKMAN!のインストールコマンドを実行してください。

インストールが完了したら、ターミナルを再起動後、以下のコマンドでSDKMAN!をシェルに読み込みます。

source "$HOME/.sdkman/bin/sdkman-init.sh"

source "$HOME/.sdkman/bin/sdkman-init.sh"

Windows (WSL2) でのセットアップ

Windows環境でSDKMAN!を利用する場合は、WSL2 (Windows Subsystem for Linux 2) を利用するのが最もスムーズです。
WSL2のセットアップがまだの場合は、Microsoftの公式ドキュメントを参考に事前にセットアップを完了させてください。

WSL2環境が準備できたら、上記macOS/Linuxと同様のコマンドでインストールできます。

アンインストール

SDKMAN!をシステムから削除するには、以下の手順を実行します。

1. (オプション) バックアップとSDKMAN!の削除:
   SDKMAN!のインストールディレクトリを削除する前に、必要に応じてバックアップを作成できます。以下のコマンドでバックアップを作成し、その後インストールディレクトリを削除します。

tar zcvf ~/sdkman-backup_$(date +%F-%kh%M).tar.gz -C ~/ .sdkman
rm -rf ~/.sdkman

tar zcvf ~/sdkman-backup_$(date +%F-%kh%M).tar.gz -C ~/ .sdkman
rm -rf ~/.sdkman

バックアップが不要な場合は、以下のコマンドで直接インストールディレクトリを削除してください。

rm -rf ~/.sdkman

rm -rf ~/.sdkman

2. シェル設定からの初期化スニペットの削除: .bashrc, .bash_profile, .profile、または .zshrc ファイルからSDKMAN!の初期化スニペットを削除します。削除すべきコードは以下のようになります。

#THIS MUST BE AT THE END OF THE FILE FOR SDKMAN TO WORK!!!
[[ -s "/home/dudette/.sdkman/bin/sdkman-init.sh" ]] && source "/home/dudette/.sdkman/bin/sdkman-init.sh"

#THIS MUST BE AT THE END OF THE FILE FOR SDKMAN TO WORK!!!
[[ -s "/home/dudette/.sdkman/bin/sdkman-init.sh" ]] && source "/home/dudette/.sdkman/bin/sdkman-init.sh"

これらの手順で、SDKMAN!はシステムから完全にアンインストールされます。

インストール後の確認と初期設定

インストールが完了したら、以下のコマンドでSDKMAN!が正しく動作しているか確認しましょう。

sdk version

sdk version

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

また、SDKMAN!はデフォルトでSDKのインストール時に署名検証を行いますが、環境によってはプロキシ設定などが必要になる場合があります。詳細は公式ドキュメントを参照してください。

これで、SDKMAN!のインストールは完了です。

その他のインストール方法

カスタムロケーションへのインストール

SDKMAN!をデフォルト以外の場所にインストールしたい場合は、インストール前に SDKMAN_DIR 環境変数を設定します。

export SDKMAN_DIR="/usr/local/sdkman" && curl -s "https://get.sdkman.io" | bash

export SDKMAN_DIR="/usr/local/sdkman" && curl -s "https://get.sdkman.io" | bash

CIモードでのインストール

CI/CDパイプラインのような自動化された環境では、非対話型でSDKMAN!をインストールするためのCIモードが利用できます。これにより、プロンプトへの自動応答、色付き出力の無効化、自己更新機能の停止が行われます。

curl -s "https://get.sdkman.io?ci=true" | bash

curl -s "https://get.sdkman.io?ci=true" | bash

4. シェルとの連携を強化する

SDKMANは、それ単体でも強力ですが、お使いのシェルと密接に連携させることで、その利便性は飛躍的に向上します。特に、ZshやFishといったモダンなシェルを使っている方には、ぜひ試していただきたい設定があります。

Zsh/Oh My Zshでの補完機能の有効化

Zshユーザー、特にOh My Zshをお使いの方なら、SDKMANの補完機能は必須です。これにより、sdk install の後にTabキーを押すだけで、インストール可能なSDKのリストが表示されたり、sdk use の後にインストール済みのバージョンが補完されたりします。設定は非常に簡単です。

あなたの .zshrc ファイルに以下の行があることを確認してください。

# .zshrc
[[ -s "/Users/your_user/.sdkman/bin/sdkman-init.sh" ]] && source "/Users/your_user/.sdkman/bin/sdkman-init.sh"

# .zshrc
[[ -s "/Users/your_user/.sdkman/bin/sdkman-init.sh" ]] && source "/Users/your_user/.sdkman/bin/sdkman-init.sh"

通常、SDKMANのインストール時に自動で追加されますが、もしなければ追加し、シェルを再起動（source ~/.zshrc）するだけでOKです。これで、SDKMANコマンドの入力効率が格段にアップします。

Fishシェルの設定

Fishシェルは、その強力な補完機能と使いやすさで人気を集めています。SDKMANもFishシェルと連携させることができます。

Fishシェル用のSDKMAN初期化スクリプトを読み込むように設定します。

# ~/.config/fish/config.fish
status --is-interactive; and . (sdkman-init.fish)

# ~/.config/fish/config.fish
status --is-interactive; and . (sdkman-init.fish)

これにより、FishシェルでもSDKMANの恩恵を最大限に受けることができます。

プロンプトに使用中のJavaバージョンを表示する

複数のプロジェクトを掛け持ちしていると、「今、どのJavaバージョンを使っているんだっけ？」と混乱することがありますよね。シェルのプロンプトに現在アクティブなJavaバージョンを表示させることで、この悩みを解消できます。

Zshの場合、.zshrc に以下のような設定を追加します。

# .zshrc
function sdk_prompt_info() {
  local java_version=$(sdk current java | awk '{print $NF}')
  if [[ -n "$java_version" ]]; then
    echo "(Java:$java_version)"
  fi
}

PROMPT='%(?.%F{green}.%F{red})%n@%m%F{blue}:%F{yellow}%~%F{green}$(sdk_prompt_info)%F{reset} %# '

# .zshrc
function sdk_prompt_info() {
  local java_version=$(sdk current java | awk '{print $NF}')
  if [[ -n "$java_version" ]]; then
    echo "(Java:$java_version)"
  fi
}

PROMPT='%(?.%F{green}.%F{red})%n@%m%F{blue}:%F{yellow}%~%F{green}$(sdk_prompt_info)%F{reset} %# '

これにより、プロンプトに (Java:17.0.9-tem) のように表示され、一目で現在のJavaバージョンが確認できるようになります。これは、プロジェクトごとに .sdkmanrc でバージョンを切り替えている場合に特に威力を発揮します。

5. よく使う操作をエイリアスで高速化する

SDKMANのコマンドは直感的ですが、さらに短く、覚えやすいエイリアスを設定することで、タイピング量を減らし、思考のフローを途切れさせずに作業を進めることができます。ここでは、私が実際に使っている便利なエイリアスをいくつかご紹介します。

プロジェクトで使うJava/Maven/Gradleを一発で切り替えるエイリアス

.sdkmanrc を使っていても、たまに手動で切り替えたい時や、特定のバージョンを試したい時があります。そんな時に便利なのが、一連のSDKをまとめて切り替えるエイリアスです。

# .zshrc または .bashrc
alias use_proj_java17='sdk use java 17.0.9-tem && sdk use maven 3.9.5 && sdk use gradle 8.5'
alias use_proj_java21='sdk use java 21.0.1-tem && sdk use maven 3.9.5 && sdk use gradle 8.5'

# .zshrc または .bashrc
alias use_proj_java17='sdk use java 17.0.9-tem && sdk use maven 3.9.5 && sdk use gradle 8.5'
alias use_proj_java21='sdk use java 21.0.1-tem && sdk use maven 3.9.5 && sdk use gradle 8.5'

このように設定しておけば、use_proj_java17 と打つだけで、プロジェクトに必要なJava、Maven、Gradleのバージョンが一括で切り替わります。もちろん、バージョンやツールはあなたの環境に合わせて調整してください。

最新のLTSバージョンを素早くインストールするエイリアス

新しいLTS（長期サポート）バージョンのJavaがリリースされた際、すぐに試したいですよね。そんな時に役立つエイリアスです。

# .zshrc または .bashrc
alias install_latest_lts_java='sdk install java $(sdk list java | grep -E "-LTS" | head -n 1 | awk "{print \$NF}")'

# .zshrc または .bashrc
alias install_latest_lts_java='sdk install java $(sdk list java | grep -E "-LTS" | head -n 1 | awk "{print \$NF}")'

このエイリアスを実行すると、sdk list java の結果から最新のLTSバージョンを自動で探し出し、インストールしてくれます。常に最新の環境に追従したい開発者には非常に便利です。

まとめ：快適なJava開発環境への第一歩

本記事では、Java開発におけるSDKバージョン管理の課題を解決するツール「SDKMAN!」について、その概要、必要性、および具体的なインストール方法を解説しました。

SDKMAN!を導入することで、複雑な環境設定から解放され、複数のSDKバージョンを容易に切り替え、JAVA_HOMEの管理に関する負担を軽減できます。これにより、開発効率が向上し、本来の業務に集中できる時間が増えるでしょう。

現代の複雑な開発環境において、SDKMAN!は開発者の生産性とプロジェクトの安定性を維持するための有効なツールと言えます。

SDKMAN!を導入し、効率的なJava開発環境を構築しましょう。

免責事項

本記事の内容は、執筆時点での情報に基づいており、SDKMAN! および関連技術の将来の変更によって、内容が古くなる可能性があります。
また、本記事は特定の環境での動作検証に基づいており、すべての環境での動作を保証するものではありません。
記事の内容を参考に作業を行う際は、ご自身の責任において実施してください。
本記事の情報を利用したことにより生じた損害について、筆者および公開元は一切の責任を負いません。