Contents
Scene Builder 23 の概要と公式ダウンロード
Scene Builder 23 は Gluon が提供する、JavaFX 22 とシームレスに連携できる最新の UI デザイナーです。本稿では 公式サイトから macOS 用 DMG を取得し、安全にインストールできるまでの手順 を解説します。macOS(Intel & Apple Silicon 両方)に対応しており、コード署名が施された正式パッケージなので、ミラーサイトや非公式ビルドを利用するリスクを回避できます。
公式ダウンロードページの概要
公式ページは以下の URL からアクセスできます。
https://gluonhq.com/products/scene-builder/
このページの上部にある「Download for macOS (Intel & Apple Silicon)」ボタンをクリックすると、最新版(2024 年 10 月時点では v23.0.1)の DMG ファイルが直接ダウンロードされます。配布ファイル名は SceneBuilder-23.0.1.dmg のようにバージョン番号が付与されており、拡張子が .dmg であることから macOS 用であることが一目で分かります。
v23 系列の主な特徴(概要)
- Java 17+ 前提:モジュラーシステムを活用した設計になっているため、JDK 17 以降が必須です。
- Apple Silicon 対応:ARM64 バイナリが同梱されており、Rosetta 2 を介さずにネイティブ実行できます。
- FXML エディタの高速化:大規模な FXML ファイルでもレイアウト表示がスムーズです。
- CSS インスペクタ強化:リアルタイムでスタイルシートを編集でき、変更結果が即座にプレビューに反映されます。
macOS のシステム要件と事前準備
Scene Builder 23 を快適に動作させるためには、macOS 本体のバージョンと JDK の組み合わせが重要です。このセクションでは 必要な OS バージョン・JDK のインストール確認方法 について詳しく説明します。
macOS と JDK の最低要件
macOS 10.15 Catalina 以降であれば、Apple Silicon(M1/M2 系)でも Intel ベースの Mac でも問題なく動作します。加えて Java 17 以上 がインストールされている必要があります。OpenJDK、Azul Zulu、Oracle JDK のいずれでも構いませんが、公式ドキュメントでは OpenJDK を推奨しています。
JDK インストールの確認手順
ターミナルで以下コマンドを実行すると、現在利用中の Java バージョンが表示されます。
|
1 2 |
$ java -version |
出力例(期待される結果)
|
1 2 3 4 |
openjdk version "17.0.9" 2023-10-17 OpenJDK Runtime Environment (build 17.0.9+1) OpenJDK 64-Bit Server VM (build 17.0.9+1, mixed mode, sharing) |
バージョンが 17.0.0 未満の場合は、Homebrew を使って最新版をインストールするのが手軽です。
|
1 2 |
$ brew install openjdk@17 |
インストール後はシェル設定ファイル(例:~/.zshrc)にパスを追加し、再起動または source ~/.zshrc で反映させます。
Apple Silicon と Intel の違い(概要)
| 項目 | Intel Mac | Apple Silicon (M1/M2) |
|---|---|---|
| 推奨 JDK | 任意の JDK 17+ | 同上 |
| Rosetta 2 必要性 | 不要(ネイティブ実行) | 不要(Scene Builder 23 が ARM64 対応) |
| 旧版との注意点 | Scene Builder 2 は Intel のみ、Rosetta 2 が必須【1】 | 最新版は直接起動可能 |
上表の通り、Apple Silicon 環境では Rosetta 2 が不要 になるため、パフォーマンスが向上します。
DMG ファイルで手動インストールする手順
公式サイトから取得した DMG を用いると、インストールプロセスを自分のペースで進められます。この章では DMG の展開・署名確認・Applications への配置 手順をステップバイステップで紹介します。
手順全体の概要
- ダウンロードした DMG をダブルクリックしてマウントする。
- Gatekeeper が提示する署名情報を確認し、信頼できる開発元かチェックする。
Scene Builder.appを Applications フォルダーへドラッグ&ドロップする。- 必要に応じてシンボリックリンクを作成し、ターミナルから直接実行できるように設定する。
1. DMG のマウントと署名確認
Finder で SceneBuilder-23.0.1.dmg を右クリック → 「開く」 を選択します。macOS が安全性を自動チェックし、以下のようなダイアログが表示されます。
“Scene Builder.app は信頼できる開発元です”。
開発者名はcom.gluonhq.scene.builderとなっており、コード署名が有効であることが確認できます。
この画面が出たら 「開く」 をクリックしてマウントを続行します。
2. Applications フォルダーへの配置
DMG がマウントされるとウィンドウ内に Scene Builder.app のアイコンが表示されます。これを Applications ディレクトリへドラッグ&ドロップしてください。コピーが完了すると、Finder で /Applications/Scene Builder.app が確認できます。
3. コマンドラインからの起動テスト
ターミナルで以下コマンドを実行し、バージョン情報が正しく表示されるか確認します。
|
1 2 3 |
$ open /Applications/Scene\ Builder.app # GUI 起動 $ /Applications/Scene\ Builder.app/Contents/MacOS/SceneBuilder --version |
出力例
|
1 2 |
Scene Builder 23.0.1 |
4. シンボリックリンクの作成(任意)
Homebrew を利用しない場合でも、scenebuilder コマンドをどこからでも呼び出せるようにシンボリックリンクを作成しておくと便利です。
|
1 2 |
$ sudo ln -s "/Applications/Scene Builder.app/Contents/MacOS/SceneBuilder" /usr/local/bin/scenebuilder |
これで scenebuilder -version と入力すれば、同様にバージョンが表示されます。
Homebrew Cask を使ったインストール方法
Homebrew が既に導入済みの環境では、cask コマンド一発で Scene Builder 23 の最新版を取得・配置できます。この章では Homebrew によるインストール手順と、インストール後の確認ポイントを解説します。
手順全体の概要
- Homebrew を最新状態に更新する。
brew install --cask scene-builderで公式 DMG を自動取得し、/Applications に配置する。- インストール先パスとバージョンをターミナルで確認する。
1. Homebrew のアップデート
|
1 2 |
$ brew update |
最新のレシピ情報が取得できるので、インストール時に古いバージョンが混入するリスクを低減できます。
2. cask インストール実行
|
1 2 |
$ brew install --cask scene-builder |
インストールが完了すると、以下のようなメッセージが表示されます。
Scene Builder was installed to /Applications/Scene Builder.app
この時点で GUI アプリは Launchpad から起動可能ですし、コマンドライン用シンボリックリンクも自動作成されます(/usr/local/bin/scenebuilder)。
3. パスとバージョンの確認
|
1 2 3 4 5 6 |
$ which scenebuilder /usr/local/bin/scenebuilder $ scenebuilder --version Scene Builder 23.0.1 |
正しくパスが通っていれば、上記コマンドでバージョン情報が表示されます。
アップデート方法
新しいリリースが公開されたら以下コマンドで自動的に置き換えられます。
|
1 2 |
$ brew upgrade --cask scene-builder |
主要 IDE への Scene Builder 連携設定
Scene Builder がインストールできても、IDE と結びつけなければ FXML の設計効率は上がりません。ここでは IntelliJ IDEA、Eclipse、NetBeans の3大 IDE に対する設定手順を具体的に示します。
各 IDE で共通するポイント
- 「外部ツール」や「JavaFX 設定」に
scenebuilder実行ファイルへのフルパスを登録する。 - 登録後は FXML ファイル上で右クリック → Open in Scene Builder が選択可能になる。
IntelliJ IDEA の設定手順
- Preferences(⌘,) → Languages & Frameworks → JavaFX を開く。
- 「Scene Builder executable」に以下のいずれかを入力する。
- Homebrew インストール時:
/usr/local/bin/scenebuilder - 手動 DMG インストール時:
/Applications/Scene Builder.app/Contents/MacOS/SceneBuilder - 設定保存後、プロジェクト内の
.fxmlファイルを右クリック → Open in Scene Builder を選択すると起動確認ができる。
Eclipse の外部ツール設定手順
- メニューから Run → External Tools → External Tools Configurations... を開く。
- 左ペインの Program を右クリックし New を選択。
-
基本情報を入力する(例):
-
Name: SceneBuilder
- Location:
/usr/local/bin/scenebuilderまたは/Applications/Scene Builder.app/Contents/MacOS/SceneBuilder -
Arguments:
--open ${resource_loc} -
「Apply」→「Run」でテスト実行し、FXML が Scene Builder にロードされれば完了。
NetBeans の統合設定手順
- メニューから Tools → Options を選択し、タブ一覧の中から JavaFX をクリック。
- 「Scene Builder Path」に同様に実行ファイルへのフルパスを入力する。
- 設定保存後、FXML エディタ右上にある Design ボタンで Scene Builder が起動すれば成功。
トラブルシューティングとよくある問題への対処
インストールや起動時にエラーが出るケースは稀ですが、環境依存の要因が多いため、事前に確認しておくと安心です。この章では 代表的なエラーパターンとその解決策 をまとめます。
起動しない場合の基本チェックリスト
| チェック項目 | 確認方法 | 対応例 |
|---|---|---|
| JDK が見つからない | scenebuilder --verbose 実行時に “Unable to locate a valid JDK” と表示されるか |
SCENEBUILDER_JDK_HOME 環境変数を正しいパスへ設定 |
| ARM64/Intel バイナリの混在 | file /Applications/Scene\ Builder.app/Contents/MacOS/SceneBuilder でアーキテクチャ確認 |
Apple Silicon では ARM64 バイナリ、Intel Mac では x86_64 が期待値 |
| Rosetta 2 が誤って有効化されている | arch -x86_64 /usr/bin/true && echo "Rosetta" で判定 |
必要がなければ Rosetta の使用をやめ、ネイティブバイナリを再インストール |
| シンボリックリンクのパス不一致 | which scenebuilder が期待外の場所を指すか確認 |
正しい実行ファイルへリンクし直す(例: ln -sf "/Applications/Scene Builder.app/Contents/MacOS/SceneBuilder" /usr/local/bin/scenebuilder) |
エラーログ取得方法
|
1 2 |
$ scenebuilder --verbose 2>&1 | tee ~/scenebuilder-log.txt |
上記コマンドは標準エラー出力を含む全ログを ~/scenebuilder-log.txt に保存します。問題が再現した際にこのファイルを添えて検索すると、公式フォーラムや GitHub Issue で同様事例が見つかりやすくなります。
JDK パス不一致の具体的解消手順
- 正しい JDK のインストール場所を確認(例:
/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home)。 - 環境変数
SCENEBUILDER_JDK_HOMEを設定。bash/zsh なら~/.zshrcに以下追記:
bash
export SCENEBUILDER_JDK_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
- 設定を反映させた後、再度バージョン確認:
bash
$ scenebuilder --version
Scene Builder 23.0.1
Rosetta 2 の有無チェックと対処
Apple Silicon Mac では以下コマンドで Rosetta 2 がインストールされているか確認できます。
|
1 2 |
$ /usr/sbin/softwareupdate --list | grep -i rosetta |
- インストール済み でも Scene Builder 23 は ARM64 対応なので、実行ファイルが Intel 用でない限り Rosetta を介する必要はありません。
- 不要な場合 はそのままで問題ありませんが、意図せず Intel バイナリを選択しないように
fileコマンドでバイナリ種別を確認しておくと安心です。
まとめ
- 公式サイト(https://gluonhq.com/products/scene-builder/)から macOS 用 DMG を取得すれば、最も安全かつ最新の Scene Builder 23 が入手できます。
- macOS 10.15 以降 + Java 17+ の環境が整っていれば、DMG 手動インストールでも Homebrew Cask インストールでも問題なく起動します。
- IDE 連携設定(IntelliJ IDEA、Eclipse、NetBeans)を行うことで、FXML のデザイン作業がワンクリックで可能になります。
- トラブルシューティングでは、JDK パスやバイナリのアーキテクチャ、Rosetta 2 の有無を中心にチェックすると多くの問題は解決できます。
これらの手順とポイントを押さえておけば、macOS 環境で JavaFX 開発を行う際の UI デザイン作業が格段に快適になるでしょう。ぜひ本記事を参考に、最新の Scene Builder 23 を導入してみてください。