# 打包 JavaFX 应用程序

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

您可以通过构建相应的制品（Java 存档）来打包您的 JavaFX 应用程序。 对于 JavaFX 应用程序，IntelliJ IDEA 提供了一种专用的 artifact 类型：   JavaFx 应用程序  。

> **Warning:**
> 使用 Java 8 在  `.jar` 中打包 JavaFX 应用程序是可能的。 对于 Java 11 及更高版本，请使用 [jlink 工具为应用程序创建软件包](javafx.html#package-app-with-jlink)。

## 生成 JavaFX 工件

Procedure: 创建新的 artifact 配置

IntelliJ IDEA 创建工件用于将应用程序与项目一起打包。 但是，您可以使用自定义设置创建新的 artifact 配置。

1. 在主菜单中，转到  `文件 | 项目结构`  `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) 并点击   构件  。

2. 请点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)，指向   JavaFx 应用程序  ，然后选择   来自模块 '...'  。

![创建新的 artifact 配置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/fx-new-artifact.png)

IntelliJ IDEA 创建工件配置，并显示其在   项目结构   对话框右侧的设置。

3. 请命名新配置。

4. 切换到   JavaFX  选项卡，在   应用程序类  字段中，指定  `main()` 方法。

5. 应用更改并关闭对话框。

![创建新工件配置：指定主类](https://resources.jetbrains.com.cn/help/img/idea/2026.3/fx-new-artifact-main.png)

> **Tip:**
> 这是一个足以打包应用程序的基本配置。 您可以在   JavaFX   选项卡上指定其他选项。 有关每个选项的详细描述，请参阅 [Java FX 选项卡](project-structure-artifacts-java-fx-tab.html)。

Procedure: 构建工件

1. 在主菜单中，前往  `构建 | 构建制品` 。

2. 在打开的弹出窗口中，选择所需的 artifact，然后选择   构建  。

默认情况下，artifact 是生成到  `<project_folder>\out\artifacts\<artifact_name>` 。

> **Tip:**
> 如果您想确保工件构建正确，请创建一个新的运行配置，并按照 [运行打包的应用程序](creating-and-running-your-first-java-application.html#run_jar_artifact)部分中的描述运行。

## 故障排除

* `Error:Java FX Packager: Can't build artifact – fx:deploy is not available in this JDK` 这项 `fx:deploy` 任务是以前在 `ant-javafx.jar` 作为 Java Packager 的一部分分发的 Ant 插件的一部分。 Ant 插件未包含在当前 JDK 版本的 jpackage 中。 如果您使用的是 9 及更高版本的 JDK 版本，请使用第三方解决方案进行打包。 例如，请参阅 JavaFX 官方文档中的第 [Runtime images](https://openjfx.io/openjfx-docs/#modular) 部分。 您可以在 [Stack Overflow](https://stackoverflow.com/a/30162808) 上找到更多打包选项。 可以使用 [jlink](javafx.html#package-app-with-jlink) 将应用程序打包成软件包，或使用包含 JavaFX 的 JDK，例如 [Bellsoft Liberica](https://bell-sw.com/) JDK 11。

