# javafx-springboot-simple-demo

**Repository Path**: lp-study-notes/javafx-springboot-simple-demo

## Basic Information

- **Project Name**: javafx-springboot-simple-demo
- **Description**: JavaFX集成SpringBoot开发桌面程序，使用开源框架 springboot-javafx-support，解决了传统 JavaFX 应用在依赖管理、配置化和企业级特性集成方面的痛点，让开发者能够充分利用 Spring 生态来构建现代化的 JavaFX 桌面应用程序。
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2026-03-04
- **Last Updated**: 2026-03-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JavaFX集成SpringBoot开发桌面程序示例

## 准备工作
JavaFX集成SpringBoot开发桌面程序需要提前准备开发环境，主要包括：

##### 1、JavaFX：17.0.17
##### 2、Spring Boot：2.7.18
##### 3、springboot-javafx-support：2.1.6	为集成 Spring Boot 和 JavaFX 而设计的开源框架
##### 4、OpenJDK：17.0.17
##### 5、IDEA开发工具：2025.2.3
##### 6、javafx-sdk：17.0.17	JavaFX应用开发工具包，使用 jpackage 命令打包 exe 时需要
##### 7、javafx-jmods：17.0.17	JavaFX模块化部署组件，使用 jpackage 命令打包 exe 时需要
##### 8、wix.exe：3.14	用于构建 Windows 安装程序，使用 jpackage 命令打包 exe 时需要

## 框架介绍
#### JavaFX
JavaFX 是一个开源的新一代客户端应用平台，适用于基于Java构建的桌面、移动端和嵌入式系统。目的是为开发丰富的客户端应用提供一个现代、高效、功能齐全的工具包。它最初是为了替代Swing而设计的，提供了更现代的UI控件、图形和媒体API、以及对CSS样式的支持。JDK 从 1.8 开始 JDK 自带JavaFX，到 JDK 11 开始不再内置 JavaFX，所以如果你使用的是高版本的 jdk 在使用 JavaFX 的时候就需要先安装 JavaFX ，并在 IDEA 里进行配置。
#### Spring Boot
Spring Boot是基于Spring的框架，通过自动配置和内置容器，极大简化了独立、生产级Spring应用的开发。Spring Boot遵循“约定大于配置”，提供起步依赖与自动配置，让开发者能快速创建可独立运行的Spring应用。Spring Boot是一个能让你快速上手、简单配置，就能跑起一个Spring应用的框架。
#### springboot-javafx-support
springboot-javafx-support  是一个专门为集成 Spring Boot 和 JavaFX 而设计的开源框架。它解决了传统 JavaFX 应用在依赖管理、配置化和企业级特性集成方面的痛点，让开发者能够充分利用 Spring 生态来构建现代化的 JavaFX 桌面应用程序。

## 创建步骤
具体查看文档 <https://blog.csdn.net/tonight_precious/article/details/154879351?spm=1011.2415.3001.5331>

## 启动项目

#### 运行'DemoApplication.main()'

在 DemoApplication 启动类中 右击 然后 点击 《运行'DemoApplication.main()'》

![img_5.png](doc/img_5.png)

错误: 缺少 JavaFX 运行时组件

![img_4.png](doc/img_4.png)


#### 正确的启动方式

编辑配置

![img.png](doc/img.png)

将以下的参数 --module-path 和 --add-modules 配置到 VM 虚拟机配置中

`--module-path "D:\javafx\javafx-sdk-17.0.17\lib;D:\javafx\javafx-jmods-17.0.17" --add-modules javafx.controls,javafx.fxml`

![img_1.png](doc/img_1.png)


然后点击运行，先弹出闪屏动画窗口，然后弹出登录窗口

![img_2.png](doc/img_2.png)

![img_3.png](doc/img_3.png)


## 生成安装版exe文件

#### 检查jpackage插件属性配置

重点检查配置：

1、主类配置：<mainClass>com.javafx.simple.demo.DemoApplication</mainClass>

2、图标配置：<icon>src/main/resources/images/gear_64x64.ico</icon>

3、启动参数：<javaOptions> 的 --module-path 和 --add-modules 

#### 点击 package 命令生成

点击 package

![img.png](doc/img6.png)

正在生成，大概需要1分钟左右

![img_1.png](doc/img_7.png)

打包成功，打印的日志有中文乱码，这个一直无法解决

![img_2.png](doc/img_8.png)

在 target/dist 已经生成了 exe 文件

![img_3.png](doc/img_9.png)

到此 JavaFX  集成 SpringBoot 开发桌面程序已经顺利完成，并且能够打包生成 安装版 exe 文件