Contents
JavaFX 25導入手順と環境構築ガイド
JavaFX 25は、JDKのモジュールシステムを活用したUI開発を可能にする最新バージョンです。本記事では、導入手順から環境構築までを網羅したチェックリストを提供します。特にJDKとJavaFXの互換性確認・環境変数設定・IDE対応手順が焦点となるため、各段階で注意点を明記しました。
JDK 25環境整備の確認
JavaFX 25はJDK 25専用で動作するため、導入前に現在のJDKバージョンを確認することが不可欠です。以下にチェックポイントを挙げます。
- JDKのインストール状況確認: コマンドプロンプトで
java -versionを実行します。 - バージョン確認: 結果が
openjdk version "25.0"であれば準備完了です。表示されない場合はOpenJDK公式サイトまたはOracle JDKの提供元からインストールしてください（注意: Oracle JDKとOpenJDKは別物ですが、JavaFXはOpenJDKに含まれています）。 - アーキテクチャ確認: 64bit環境が必須です。
java -d64 -versionで確認できます。
blockquote: Windows 7は非推奨のため、OSバージョンをWindows 10以降に変更することをおすすめします（Microsoft公式）。
OpenJFX 25 SDKダウンロード手順
JavaFXはOpenJFXとして公式サイトから入手可能です。以下の手順で正しいバージョンを選びましょう。
ダウンロード手順概要
- OpenJFX公式サイトにアクセス。
- 「Download」タブを選択し、「SDK」をクリック。
- JavaFX SDK 25.0.0を選び、OSアーキテクチャ（x64）に対応するファイルをダウンロード。
blockquote: 当記事執筆時点では
openjfx-25.0.0_windows-x64_bin-sdk.zipが最新版ですが、将来的に変更される可能性があります。**リリースノート](https://github.com/openjdk/jfx/releases)で最新ファイルを確認してください。
ファイル配置先の推奨設定
ZIPファイルは以下のような固定ディレクトリに展開することを推奨します：
| 項目 | 値 | 補足 |
|---|---|---|
| 保存場所 | C:\OpenJFX\25.0.0 |
システム変数の設定が容易になります |
| ファイル名例 | javafx-base-25.0.0.jar |
モジュールシステム対応のライブラリ |
環境変数設定（PATH・JAVA_HOME）
JavaFXをプロジェクトで利用するには、環境変数を正しく設定することが必要です。
システム変数編集手順
- [Win]+Rキーで
sysdm.cplを入力。 - 「システムのプロパティ」→「環境変数」タブを開く。
-
新規変数作成または既存変数の編集：
-
JAVA_HOME:
C:\Program Files\Java\jdk-25.0.0 - PATH（追加）:
%JAVA_HOME%\bin;%OPENJFX_HOME%\lib
環境変数確認コマンド
|
1 2 3 |
echo %JAVA_HOME% javac -version # JDKが正しく認識されているか |
blockquote:
%OPENJFX_HOME%は、JavaFXライブラリの配置先（例:C:\OpenJFX\25.0.0）を環境変数として定義してください。
IDEでのプロジェクト構成ガイド
Visual Studio CodeとIntelliJ IDEAに焦点を当てた設定手順を解説します。
Visual Studio Codeの準備
- VS Code起動 → 「Extensions」タブを開く。
- Java Extension Pack（含む「Language Support for Java(TM) by Red Hat」）をインストール。
- プロジェクトフォルダに
src/main/javaディレクトリを作成。
IntelliJ IDEAの設定
- 新規プロジェクト作成 → 「Project SDK」でJDK 25を選択。
- 「Add Framework Support」→「JavaFX」をチェック。
module-info.javaに以下を追加：
|
1 2 3 |
requires javafx.controls; requires javafx.fxml; |
blockquote: Java 9以降では、モジュール宣言がないとライブラリが読み込めません。プロジェクト構成時に「Add Module Declaration」オプションを使用してください。
コマンドラインでのJavaFX実行設定
JavaFXアプリケーションを起動するには--module-pathと--add-modulesの両方を指定します。
実行コマンド例
|
1 2 3 4 |
java --module-path "C:\OpenJFX\25.0.0\lib" \ --add-modules javafx.controls,javafx.fxml \ -cp .;target/classes MainClass |
blockquote:
--module-pathにはJavaFXライブラリのパスを、--add-modulesには使用するモジュール名（例:javafx.controls）を記載します。
IDE設定による自動指定方法
- VS Code:
.vscode/launch.jsonに以下を追加：
|
1 2 3 4 5 |
"runtimeOptions": { "modulePath": ["${env:OPENJFX_HOME}/lib"], "addModules": ["javafx.controls", "javafx.fxml"] } |
- IntelliJ IDEA: 「Run/Debug Configurations」→「VM options」に以下を入力：
|
1 2 |
--module-path ${env.OPENJFX_HOME}/lib --add-modules javafx.controls,javafx.fxml |
まとめ: JavaFX導入のポイント整理
| 項目 | 内容 | 注意点 |
|---|---|---|
| JDKバージョン | JDK 25専用 | Oracle JDK/OpenJDKはどちらも可（OpenJFXはOpenJDKに含まれる） |
| OS環境 | Windows 10以降推奨 | Windows 7は非推奨（公式サポート終了） |
| モジュール宣言 | module-info.java必須 |
Java 9以降の導入時に必要 |
| 環境変数 | JAVA_HOMEとOPENJFX_HOMEを設定 |
不正なパスはエラー原因になる |
（本文終了）