/*@jsxRuntime automatic @jsxImportSource react*/ /*Corrected indentation for ArticleImage*/ /*Corrected indentation for ArticleImage*/ /*Corrected indentation for ArticleImage*/ const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0]; const {useMDXComponents: _provideComponents} = arguments[0]; function _createMdxContent(props) { const _components = Object.assign({ p: "p", ul: "ul", li: "li", strong: "strong", code: "code", h2: "h2", a: "a", span: "span", hr: "hr", em: "em", pre: "pre", ol: "ol" }, _provideComponents(), props.components), {BackgroundInfo, ExternalLink, CollapseDropdown, ArticleImage} = _components; if (!ArticleImage) _missingMdxReference("ArticleImage", true); if (!BackgroundInfo) _missingMdxReference("BackgroundInfo", true); if (!CollapseDropdown) _missingMdxReference("CollapseDropdown", true); if (!ExternalLink) _missingMdxReference("ExternalLink", true); return _jsxs(_Fragment, { children: [_jsxs(BackgroundInfo, { title: "Related Java Setup Guides", children: [_jsxs(_components.p, { children: ["-", " "] }), _jsx(ExternalLink, { href: "/blog/project-level-java-maven-gradle-versioning", children: _jsx(_components.p, { children: "Core Guide: Java, Maven & Gradle Setup & Usage" }) }), _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "This Article: Specifics for Setting up JavaFX" }), " -", " "] }), "\n"] }), _jsx(ExternalLink, { href: "/blog/setting-up-modern-spring-boot-web-server-rest-api-web-content-2025-guide", children: _jsx(_components.p, { children: "Specifics: Setting up a Spring Boot Server" }) })] }), "\n", _jsxs(BackgroundInfo, { title: "Overview: JavaFX Key Components", children: [_jsxs(_components.p, { children: ["This guide focuses on setting up a JavaFX development environment. Key parts: - ", _jsx(_components.strong, { children: "JDK Setup" }), ":\nAssumed to be done. For initial JDK installation and ", _jsx(_components.code, { children: "JAVA_HOME" }), " setup, refer to the", " "] }), _jsx(ExternalLink, { href: "/blog/project-level-java-maven-gradle-versioning#part-1-os-level-tool-installation-the-foundation", children: _jsx(_components.p, { children: "Core Java Setup Guide" }) }), _jsxs(_components.p, { children: [". - ", _jsx(_components.strong, { children: "Build Tool (Maven/Gradle)" }), ": Manages JavaFX libraries as project dependencies. This is\ncovered in detail in the", " "] }), _jsx(ExternalLink, { href: "/blog/project-level-java-maven-gradle-versioning", children: _jsx(_components.p, { children: "Core Java Guide" }) }), _jsxs(_components.p, { children: [". This article will show JavaFX-specific dependency examples. - ", _jsx(_components.strong, { children: "FXML" }), ": XML for UI layout,\nseparating design from Java logic. - ", _jsx(_components.strong, { children: "SceneBuilder" }), ": Visual tool for FXML design."] })] }), "\n", _jsxs(_components.h2, { id: "part-1-javafx-project-setup-in-ides", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#part-1-javafx-project-setup-in-ides", children: _jsx(_components.span, { className: "icon icon-link" }) }), "Part 1: JavaFX Project Setup in IDEs"] }), "\n", _jsxs(_components.p, { children: ["This section assumes your JDK is installed and ", _jsx(_components.code, { children: "JAVA_HOME" }), " is configured as per the ", _jsx(ExternalLink, { href: "/blog/project-level-java-maven-gradle-versioning", children: "Core Java Guide" }), ". We'll focus on IDE integration for JavaFX."] }), "\n", _jsx(BackgroundInfo, { title: "What is JavaFX?", children: _jsxs(_components.p, { children: ["JavaFX is a toolkit for developing graphical (GUI) applications in Java. Since Java 11, it's no\nlonger bundled with the JDK. It's best managed as a project dependency via Maven or Gradle.\n", _jsx(_components.strong, { children: "Avoid installing JavaFX system-wide." })] }) }), "\n", _jsx(CollapseDropdown, { summary: "1.1: VS Code with Java Extension Pack", children: _jsx("div", { children: _jsx(ExternalLink, { href: "https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-pack", children: _jsx(_components.p, { children: "Install the Extension Pack for Java in VS Code." }) }) }) }), "\n", _jsx(CollapseDropdown, { summary: "1.2: IntelliJ IDEA (Community or Ultimate)", children: _jsx("div", { children: "IntelliJ IDEA has excellent built-in support for Java and JavaFX projects." }) }), "\n", _jsxs(BackgroundInfo, { title: "Version Compatibility for JavaFX", children: [_jsx("div", { children: "Use the latest Long-Term Support (LTS) versions consistently. For example:" }), _jsxs("ul", { children: [_jsx("li", { children: _jsx("strong", { children: "JDK 21" }) }), _jsx("li", { children: _jsxs(_components.p, { children: [_jsx("strong", { children: "JavaFX 21" }), " (or a version compatible with your JDK, such as JavaFX 22+ for JDK 21+)"] }) }), _jsx("li", { children: _jsxs(_components.p, { children: [_jsx("strong", { children: "Scene Builder 23" }), " (or the latest corresponding LTS)"] }) })] }), _jsx("div", { children: _jsxs(_components.p, { children: ["Ensure your ", _jsx("code", { children: "pom.xml" }), " or ", _jsx("code", { children: "build.gradle" }), " reflects these versions. See", " ", "\n", _jsx("a", { href: "#javafx-jdk-compatibility", children: "Part 5.1" }), " for a ", _jsx("code", { children: "pom.xml" }), " example."] }) })] }), "\n", _jsx(_components.hr, {}), "\n", _jsxs(_components.h2, { id: "part-2-integrating-scene-builder", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#part-2-integrating-scene-builder", children: _jsx(_components.span, { className: "icon icon-link" }) }), "Part 2: Integrating Scene Builder"] }), "\n", _jsx(_components.p, { children: "Scene Builder is a visual layout tool for designing JavaFX UIs (.fxml files)." }), "\n", _jsx(CollapseDropdown, { summary: "2.1: Download and Install Scene Builder", children: _jsx("div", { children: _jsxs(_components.p, { children: ["Visit the ", _jsx(ExternalLink, { href: "https://gluonhq.com/products/scene-builder/", children: "Gluon Scene Builder website" }), " to download the\nlatest version (LTS recommended, e.g., 23). Install it."] }) }) }), "\n", _jsxs(CollapseDropdown, { summary: "2.2: Configure Path in IntelliJ IDEA", children: [_jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: ["Go to ", _jsx(_components.strong, { children: "Settings/Preferences > Languages & Frameworks > JavaFX" }), "."] }), "\n", _jsxs(_components.li, { children: ["Set \"Path to SceneBuilder\" to your installation (e.g., ", _jsx(_components.code, { children: "/Applications/SceneBuilder.app" }), " on macOS, or ", _jsx(_components.code, { children: "C:\\Program Files\\SceneBuilder\\SceneBuilder.exe" }), " on Windows)."] }), "\n"] }), _jsx(ArticleImage, { src: "/images/posts/setup-javafx-path-in-idea-part1.png", alt: "Setting Scene Builder path in IntelliJ IDEA Preferences", caption: "Navigate to Languages & Frameworks > JavaFX in IntelliJ settings" }), _jsx(ArticleImage, { src: "/images/posts/setup-javafx-path-in-idea-part2.png", alt: "Selecting Scene Builder application path in IntelliJ IDEA", caption: "Select the Scene Builder application executable path" })] }), "\n", _jsxs(CollapseDropdown, { summary: "2.3: Configure Path in VS Code", children: [_jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: ["Install the ", _jsx(_components.a, { href: "https://marketplace.visualstudio.com/items?itemName=bilalekrem.scenebuilderextension", children: "SceneBuilder extension for Visual Studio\nCode" }), ". *\nOpen the Command Palette (", _jsx(_components.strong, { children: "Cmd+Shift+P" }), " on macOS, ", _jsx(_components.strong, { children: "Ctrl+Shift+P" }), " on Windows) * Type ", _jsx(_components.code, { children: "Configure Scene Builder path" }), " and press enter * Browse to and select your installed Scene Builder executable"] }), "\n"] }), _jsx(ArticleImage, { src: "/images/posts/configure-scene-builder-path.png", alt: "Setting Scene Builder path via Command Palette in VS Code", caption: "Use the Command Palette (Cmd/Ctrl+Shift+P) to set the SceneBuilder path in VS Code" }), _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: ["Once configured, you can right-click an ", _jsx(_components.code, { children: ".fxml" }), " file in the VS Code explorer and choose \"Open in\nScene Builder\". We'll cover how to create the project and open it in Scene Builder in the next\nstep below."] }), "\n"] }), _jsx(BackgroundInfo, { title: "Does Scene Builder require environment variables?", children: _jsxs(_components.p, { children: ["Scene Builder is self-contained and doesn't need ", _jsx(_components.code, { children: "JAVA_HOME" }), ". It edits ", _jsx(_components.code, { children: ".fxml" }), " files directly.\nYou only need to configure the path within your IDE to enable direct opening of FXML files."] }) })] }), "\n", _jsx(_components.hr, {}), "\n", _jsxs(_components.h2, { id: "part-3-creating-a-javafx-project", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#part-3-creating-a-javafx-project", children: _jsx(_components.span, { className: "icon icon-link" }) }), "Part 3: Creating a JavaFX Project"] }), "\n", _jsx(_components.p, { children: "With your JDK and Scene Builder configured, create a new JavaFX project." }), "\n", _jsxs(CollapseDropdown, { summary: "3.1: Create New Project in IntelliJ IDEA", children: [_jsxs(_components.ul, { children: ["\n", _jsx(_components.li, { children: _jsx(_components.strong, { children: "File > New > Project..." }) }), "\n", _jsxs(_components.li, { children: ["Select ", _jsx(_components.strong, { children: "JavaFX" }), "."] }), "\n", _jsx(_components.li, { children: "Choose your project SDK (e.g., Java 21)." }), "\n", _jsxs(_components.li, { children: ["Select ", _jsx(_components.strong, { children: "Maven" }), " or ", _jsx(_components.strong, { children: "Gradle" }), " as the build system."] }), "\n", _jsxs(_components.li, { children: ["Fill in project details (Name, GroupId, ArtifactId). Click ", _jsx(_components.strong, { children: "Create" }), "."] }), "\n"] }), _jsx(ArticleImage, { src: "/images/posts/jetbrains-ide-new-javafx-project.png", alt: "Creating a new JavaFX project in IntelliJ IDEA", caption: "IntelliJ IDEA New Project wizard for JavaFX" })] }), "\n", _jsxs(CollapseDropdown, { summary: "3.2: Create New Project in VS Code", children: [_jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: ["Open the Command Palette (", _jsx(_components.strong, { children: "Cmd+Shift+P" }), " on macOS, ", _jsx(_components.strong, { children: "Ctrl+Shift+P" }), " on Windows)."] }), "\n", _jsxs(_components.li, { children: ["Type ", _jsx(_components.code, { children: "Java: Create Java Project" }), " and press Enter"] }), "\n", _jsxs(_components.li, { children: ["Select ", _jsx(_components.strong, { children: "JavaFX" }), " from the list"] }), "\n", _jsxs(_components.li, { children: ["It'll ask for your desired repository version number for this new project, you can just hit enter to proceed with the default (", _jsx(_components.em, { children: "'version' 1.0-SNAPSHOT" }), ")"] }), "\n", _jsxs(_components.li, { children: ["When prompted to confirm (Y/N), make sure you hit N to be able to change the JavaFX version to 21 (", _jsx(_components.em, { children: "no other details should need changed, just hit enter to proceed with the default each time" }), ")"] }), "\n", _jsx(_components.li, { children: "Choose a folder location for your new project" }), "\n"] }), _jsx(ArticleImage, { src: "/images/posts/vscode-new-javafx-project-settings-steps.png", alt: "VS Code command palette and prompts for creating a new JavaFX project", caption: "Use the Command Palette (Cmd/Ctrl+Shift+P) -> 'Java: Create Java Project' -> 'JavaFX' and follow the prompts" }), _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: ["Once created, VS Code will open the new project. You can test run it:", "\n", _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: ["Open the ", _jsx(_components.code, { children: "App.java" }), " file (usually under ", _jsx(_components.code, { children: "src/main/java/com/example/" }), ")."] }), "\n", _jsxs(_components.li, { children: ["Click the \"Run\" button that appears above the ", _jsx(_components.code, { children: "main" }), " method or press ", _jsx(_components.strong, { children: "F5" }), "."] }), "\n"] }), "\n"] }), "\n"] }), _jsx(ArticleImage, { src: "/images/posts/vscode-test-new-javafx-gui-project.png", alt: "VS Code showing the run button for App.java and the resulting JavaFX window", caption: "Run the default App.java to ensure the JavaFX project builds and displays the initial window" }), _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: ["\n", _jsxs(_components.p, { children: ["After the project is successfully created, VS Code will show a notification. Click ", _jsx(_components.strong, { children: "Open" }), " to load the project in a new window."] }), "\n", _jsx(ArticleImage, { src: "/images/posts/vscode-after-creating-javafx-project-proceed-to-open.png", alt: "VS Code notification showing successful project creation with an Open button", caption: "Click the 'Open' button in the notification to open your new JavaFX project" }), "\n"] }), "\n"] })] }), "\n", _jsx(BackgroundInfo, { title: "JavaFX Application Components", children: _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: [_jsxs(_components.strong, { children: ["FXML Files (", _jsx(_components.code, { children: "primary.fxml" }), ", etc.)"] }), ": XML for GUI layout. - ", _jsx(_components.strong, { children: "Java Controllers" }), ": Logic for\nFXML views. - ", _jsx(_components.strong, { children: "Scene Builder" }), ": Visual FXML editor. - ", _jsxs(_components.strong, { children: ["Build File (", _jsx(_components.code, { children: "pom.xml" }), " /\n", _jsx(_components.code, { children: "build.gradle" }), ")"] }), ": Manages JavaFX library dependencies. FXML promotes separation of UI design from\napplication logic."] }), "\n"] }) }), "\n", _jsx(_components.hr, {}), "\n", _jsxs(_components.h2, { id: "part-4-opening-fxml-files-in-scene-builder", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#part-4-opening-fxml-files-in-scene-builder", children: _jsx(_components.span, { className: "icon icon-link" }) }), "Part 4: Opening FXML Files in Scene Builder"] }), "\n", _jsx(_components.p, { children: "Once your project is open and Scene Builder path is configured (Part 2), edit FXML files from your IDE." }), "\n", _jsxs(CollapseDropdown, { summary: "4.1: IntelliJ IDEA", children: [_jsx(ArticleImage, { src: "/images/posts/intellij-javafx-file-structure-with-fxml.png", alt: "IntelliJ IDEA project structure for JavaFX showing HelloApplication.java and hello-view.fxml", caption: "Default IntelliJ JavaFX project structure.", size: "small" }), _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: ["\n", _jsxs(_components.p, { children: ["In Project tool window, navigate to your FXML file (e.g., ", _jsx(_components.code, { children: "src/main/resources/com/example/hello-view.fxml" }), ")."] }), "\n"] }), "\n", _jsxs(_components.li, { children: ["\n", _jsxs(_components.p, { children: ["Right-click > ", _jsx(_components.strong, { children: "Open In SceneBuilder" }), "."] }), "\n", _jsx(ArticleImage, { src: "/images/posts/intellij-idea-how-to-open-javafx-in-scene-builder.png", alt: "Right-clicking an FXML file in IntelliJ Project view showing the 'Open In SceneBuilder' option", caption: "IntelliJ: Right-click FXML > Open In SceneBuilder", size: "full" }), "\n"] }), "\n"] })] }), "\n", _jsxs(CollapseDropdown, { summary: "4.2: VS Code", children: [_jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: ["In Explorer, navigate to FXML file (e.g., ", _jsx(_components.code, { children: "src/main/resources/com/example/primary.fxml" }), ")."] }), "\n", _jsxs(_components.li, { children: ["Right-click > ", _jsx(_components.strong, { children: "Open in Scene Builder" }), "."] }), "\n"] }), _jsx(ArticleImage, { src: "/images/posts/vscode-how-to-open-javafx-fxml-files-in-scene-builder.png", alt: "Right-clicking an FXML file in VS Code Explorer showing the 'Open in Scene Builder' option", caption: "VS Code: Right-click FXML > Open in Scene Builder", size: "medium" })] }), "\n", _jsxs(CollapseDropdown, { summary: "4.3: Editing with Scene Builder", children: [_jsx("div", { children: _jsxs(_components.p, { children: ["Scene Builder launches as a separate application, loading your FXML file for visual editing (component hierarchy, drag-and-drop, property inspection).\nChanges saved in Scene Builder are written back to the ", _jsx(_components.code, { children: ".fxml" }), " file in your project."] }) }), _jsx(ArticleImage, { src: "/images/posts/scenebuilder-successful-editing-view.png", alt: "Scene Builder application showing a JavaFX view with Library, Hierarchy, and Inspector panes", caption: "Scene Builder interface for visual FXML editing", size: "full" })] }), "\n", _jsx(_components.hr, {}), "\n", _jsx("a", { id: "diagnosing-errors" }), "\n", _jsxs(_components.h2, { id: "part-5-diagnosing-errors", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#part-5-diagnosing-errors", children: _jsx(_components.span, { className: "icon icon-link" }) }), "Part 5: Diagnosing Errors"] }), "\n", _jsx("a", { id: "javafx-jdk-compatibility" }), "\n", _jsxs(CollapseDropdown, { summary: "5.1: JavaFX & JDK Version Compatibility", children: [_jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Issue" }), ": Errors like \"package does not exist\", \"cannot find symbol\", or runtime linkage errors with JavaFX components."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Fix" }), ": Ensure your JavaFX version (in ", _jsx(_components.code, { children: "pom.xml" }), " or ", _jsx(_components.code, { children: "build.gradle" }), ") is compatible with your project's JDK. For JDK 21, use JavaFX 21+.", "\n", _jsx(_components.pre, { className: "language-xml", children: _jsxs(_components.code, { className: "language-xml", children: [_jsx(_components.span, { className: "token comment", children: "" }), "\n", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "properties"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "project.build.sourceEncoding"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "UTF-8", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "maven.compiler.release"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "21", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), " ", _jsx(_components.span, { className: "token comment", children: "" }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "javafx.version"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "21.0.2", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), " ", _jsx(_components.span, { className: "token comment", children: "" }), "\n", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n\n", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "dependencies"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "dependency"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "groupId"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "org.openjfx", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "artifactId"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "javafx-controls", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "version"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "${javafx.version}", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "dependency"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "groupId"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "org.openjfx", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "artifactId"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "javafx-fxml", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "version"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "${javafx.version}", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsx(_components.span, { className: "token comment", children: "" }), "\n", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n\n", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "build"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "plugins"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "plugin"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "groupId"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "org.apache.maven.plugins", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "artifactId"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "maven-compiler-plugin", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "version"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "3.11.0", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), " ", _jsx(_components.span, { className: "token comment", children: "" }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "configuration"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "release"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "${maven.compiler.release}", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "plugin"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "groupId"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "org.openjfx", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "artifactId"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "javafx-maven-plugin", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "version"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "0.0.8", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), " ", _jsx(_components.span, { className: "token comment", children: "" }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "configuration"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "\n ", _jsx(_components.span, { className: "token comment", children: "" }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "mainClass"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "com.example.yourproject.YourMainAppClass", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "executions"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "execution"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "\n ", _jsx(_components.span, { className: "token comment", children: "" }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "id"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "default-cli", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "configuration"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "mainClass"] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "com.example.yourproject.YourMainAppClass", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n ", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n"] }) }), "\n"] }), "\n"] }), _jsxs("ul", { children: [_jsx("li", { children: _jsxs(_components.p, { children: [_jsx("strong", { children: "Verify JDK in IDE" }), ": Confirm IDE's project SDK matches your JavaFX dependencies and build config."] }) }), _jsxs("li", { children: [_jsxs(_components.p, { children: ["For general JDK, ", _jsx("code", { children: "JAVA_HOME" }), ", multiple Java versions, and build system (Maven/Gradle) setup, refer to\nthe", " "] }), _jsx(ExternalLink, { href: "/blog/project-level-java-maven-gradle-versioning", children: _jsx(_components.p, { children: "Core Java, Maven & Gradle Setup Guide" }) }), _jsx(_components.p, { children: "." })] })] })] }), "\n", _jsx("a", { id: "scene-builder-integration-issues" }), "\n", _jsx(CollapseDropdown, { summary: "5.2: Scene Builder Integration Issues", children: _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Issue" }), ": \"Open in SceneBuilder\" option missing or not working. - ", _jsx(_components.strong, { children: "Fix" }), ": 1. Confirm Scene\nBuilder is installed. 2. Verify IDE path to Scene Builder is correct (Part 2.2 & 2.3). 3. Ensure\nFXML file is valid XML. 4. Restart IDE."] }), "\n"] }) }), "\n", _jsx("a", { id: "fxml-loading-errors" }), "\n", _jsx(CollapseDropdown, { summary: "5.3: FXML Loading Errors at Runtime", children: _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Issue" }), ": ", _jsx(_components.code, { children: "javafx.fxml.LoadException" }), ", ", _jsx(_components.code, { children: "InvocationTargetException" }), ", ", _jsx(_components.code, { children: "ClassNotFoundException" }), "."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Fixes" }), ":", "\n", _jsxs(_components.ol, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Controller Class Path" }), ": ", _jsx(_components.code, { children: "fx:controller" }), " in FXML must be fully qualified (e.g., ", _jsx(_components.code, { children: "com.example.yourproject.MyController" }), ").", "\n", _jsx(_components.pre, { className: "language-xml", children: _jsxs(_components.code, { className: "language-xml", children: [_jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "<" }), "VBox"] }), " ", _jsxs(_components.span, { className: "token attr-name", children: [_jsx(_components.span, { className: "token namespace", children: "xmlns:" }), "fx"] }), _jsxs(_components.span, { className: "token attr-value", children: [_jsx(_components.span, { className: "token punctuation attr-equals", children: "=" }), _jsx(_components.span, { className: "token punctuation", children: "\"" }), "http://javafx.com/fxml/1", _jsx(_components.span, { className: "token punctuation", children: "\"" })] }), " ", _jsxs(_components.span, { className: "token attr-name", children: [_jsx(_components.span, { className: "token namespace", children: "fx:" }), "controller"] }), _jsxs(_components.span, { className: "token attr-value", children: [_jsx(_components.span, { className: "token punctuation attr-equals", children: "=" }), _jsx(_components.span, { className: "token punctuation", children: "\"" }), "com.example.yourproject.PrimaryController", _jsx(_components.span, { className: "token punctuation", children: "\"" })] }), _jsx(_components.span, { className: "token punctuation", children: ">" })] }), "...", _jsxs(_components.span, { className: "token tag", children: [_jsxs(_components.span, { className: "token tag", children: [_jsx(_components.span, { className: "token punctuation", children: "" })] }), "\n"] }) }), "\n"] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Controller Constructor" }), ": Must have a no-argument constructor."] }), "\n", _jsxs(_components.li, { children: [_jsxs(_components.strong, { children: [_jsx(_components.code, { children: "@FXML" }), " Annotations"] }), ": UI elements in FXML with ", _jsx(_components.code, { children: "fx:id" }), " need corresponding ", _jsx(_components.code, { children: "@FXML" }), " annotated fields in the controller.", "\n", _jsx(_components.pre, { className: "language-java", children: _jsxs(_components.code, { className: "language-java", children: [_jsx(_components.span, { className: "token comment", children: "// PrimaryController.java" }), "\n", _jsx(_components.span, { className: "token keyword", children: "public" }), " ", _jsx(_components.span, { className: "token keyword", children: "class" }), " ", _jsx(_components.span, { className: "token class-name", children: "PrimaryController" }), " ", _jsx(_components.span, { className: "token punctuation", children: "{" }), "\n ", _jsx(_components.span, { className: "token annotation punctuation", children: "@FXML" }), " ", _jsx(_components.span, { className: "token keyword", children: "private" }), " ", _jsx(_components.span, { className: "token class-name", children: "Label" }), " myLabel", _jsx(_components.span, { className: "token punctuation", children: ";" }), " ", _jsx(_components.span, { className: "token comment", children: "// fx:id=\"myLabel\"" }), "\n ", _jsx(_components.span, { className: "token annotation punctuation", children: "@FXML" }), " ", _jsx(_components.span, { className: "token keyword", children: "private" }), " ", _jsx(_components.span, { className: "token keyword", children: "void" }), " ", _jsx(_components.span, { className: "token function", children: "initialize" }), _jsx(_components.span, { className: "token punctuation", children: "(" }), _jsx(_components.span, { className: "token punctuation", children: ")" }), " ", _jsx(_components.span, { className: "token punctuation", children: "{" }), " ", _jsx(_components.span, { className: "token comment", children: "/* ... */" }), " ", _jsx(_components.span, { className: "token punctuation", children: "}" }), "\n", _jsx(_components.span, { className: "token punctuation", children: "}" }), "\n"] }) }), "\n"] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Resource Path" }), ": FXML files in correct resource path (e.g., ", _jsx(_components.code, { children: "src/main/resources/com/example/yourproject/" }), ") and loaded correctly:", "\n", _jsx(_components.pre, { className: "language-java", children: _jsxs(_components.code, { className: "language-java", children: [_jsx(_components.span, { className: "token class-name", children: "Parent" }), " root ", _jsx(_components.span, { className: "token operator", children: "=" }), " ", _jsx(_components.span, { className: "token class-name", children: "FXMLLoader" }), _jsx(_components.span, { className: "token punctuation", children: "." }), _jsx(_components.span, { className: "token function", children: "load" }), _jsx(_components.span, { className: "token punctuation", children: "(" }), _jsx(_components.span, { className: "token function", children: "getClass" }), _jsx(_components.span, { className: "token punctuation", children: "(" }), _jsx(_components.span, { className: "token punctuation", children: ")" }), _jsx(_components.span, { className: "token punctuation", children: "." }), _jsx(_components.span, { className: "token function", children: "getResource" }), _jsx(_components.span, { className: "token punctuation", children: "(" }), _jsx(_components.span, { className: "token string", children: "\"primary.fxml\"" }), _jsx(_components.span, { className: "token punctuation", children: ")" }), _jsx(_components.span, { className: "token punctuation", children: ")" }), _jsx(_components.span, { className: "token punctuation", children: ";" }), " ", _jsx(_components.span, { className: "token comment", children: "// Relative to class" }), "\n", _jsx(_components.span, { className: "token comment", children: "// Or: FXMLLoader.load(getClass().getResource(\"/com/example/yourproject/primary.fxml\")); // Absolute from classpath root" }), "\n"] }) }), "\n"] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Build System" }), ": Ensure Maven/Gradle includes resources."] }), "\n"] }), "\n"] }), "\n"] }) }), "\n", _jsx(BackgroundInfo, { title: "General Troubleshooting", children: _jsxs("ul", { children: [_jsx("li", { children: _jsxs(_components.p, { children: [_jsx("strong", { children: "Clean and Rebuild" }), ": ", _jsx("code", { children: "./mvnw clean install" }), " or", " ", "\n", _jsx("code", { children: "./gradlew clean build" }), "."] }) }), _jsx("li", { children: _jsxs(_components.p, { children: [_jsx("strong", { children: "Check Logs" }), ": Review the full error stack trace in the IDE console."] }) }), _jsx("li", { children: _jsxs(_components.p, { children: [_jsx("strong", { children: "Simplify" }), ": Create a minimal reproducible example to isolate the issue."] }) })] }) }), "\n", _jsx("a", { id: "intellij-maven-menu" }), "\n", _jsxs(CollapseDropdown, { summary: "5.4: IntelliJ IDEA's Maven Project Options (If using Maven)", children: [_jsxs("div", { children: ["When you right-click on your project's ", _jsx(_components.code, { children: "pom.xml" }), " file or the project root in IntelliJ IDEA, you get a Maven-specific context menu. Here's what the common options do:"] }), _jsx(ArticleImage, { src: "/images/posts/jetbrains-idea-maven-context-menu.png", alt: "IntelliJ IDEA Maven context menu options", caption: "Common Maven actions accessible via right-click in IntelliJ IDEA", size: "medium" }), _jsxs("ul", { children: [_jsx("li", { children: _jsxs(_components.p, { children: [_jsx("strong", { children: "Sync Project" }), ": Reads your ", _jsx("code", { children: "pom.xml" }), " file and updates IntelliJ\nIDEA's project structure, dependencies, and settings to match. Use this after changing", " ", "\n", _jsx("code", { children: "pom.xml" }), " or when the IDE appears out of sync."] }) }), _jsx("li", { children: _jsxs(_components.p, { children: [_jsx("strong", { children: "Generate Sources and Update Folders" }), ": Runs Maven phases that might generate\nsource code, such as annotation processors or build plugins, and tells IDEA to recognize those\ngenerated sources and folders correctly."] }) }), _jsx("li", { children: _jsxs(_components.p, { children: [_jsx("strong", { children: "Ignore Projects" }), ": Temporarily tells IntelliJ IDEA to stop treating the selected\nmodule as a Maven project. This can help when troubleshooting or excluding a module without\nremoving it."] }) }), _jsx("li", { children: _jsxs(_components.p, { children: [_jsx("strong", { children: "Unlink Maven Projects" }), ": Removes Maven integration from the project within\nIntelliJ IDEA. The ", _jsx("code", { children: "pom.xml" }), " file remains, but IDEA will no longer manage\ndependencies or build settings through Maven until you re-import the project."] }) }), _jsx("li", { children: _jsxs(_components.p, { children: [_jsx("strong", { children: "Create 'settings.xml'" }), ": Creates a Maven ", _jsx("code", { children: "settings.xml" }), " in\n", _jsx("code", { children: "~/.m2/settings.xml" }), " if one does not already exist. Use it for user-specific Maven\nsettings such as custom repositories, proxy settings, or server credentials."] }) }), _jsx("li", { children: _jsxs(_components.p, { children: [_jsx("strong", { children: "Download Sources / Documentation" }), ": Fetches dependency source code and Javadoc\nfrom Maven repositories so you can navigate library code and read docs directly in the IDE.\n“Download Sources and Documentation” performs both actions together."] }) }), _jsx("li", { children: _jsxs(_components.p, { children: [_jsx("strong", { children: "Show Effective POM" }), ": Calculates and displays the final Project Object Model\nMaven uses, including inherited parent settings, active profiles, and merged configuration."] }) })] })] })] }); } function MDXContent(props = {}) { const {wrapper: MDXLayout} = Object.assign({}, _provideComponents(), props.components); return MDXLayout ? _jsx(MDXLayout, Object.assign({}, props, { children: _jsx(_createMdxContent, props) })) : _createMdxContent(props); } return { default: MDXContent }; function _missingMdxReference(id, component) { throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it."); }