带 JavaFX 2.1 的 NetBeans IDE
JavaFX 提供了一个基于 Java 的强大 UI 平台,可用于处理大型数据驱动业务应用程序。JavaFX 2 是 JavaFX 平台的主要更新版。从此版本开始,开发者可以完全使用 Java 创建 JavaFX 应用程序。
NetBeans IDE 支持创建 JavaFX 2 应用程序。
目录

要学习本教程,您需要具备以下软件和资源。
安装 NetBeans IDE 和 JavaFX 2.1 SDK
如果操作系统允许,您可以安装 Java JDK 捆绑提供的 JavaFX 2.1。否则,必须单独安装 JavaFX 2.1。
- 对于 Windows,JavaFX 2.1 随 JDK 1.7 Update 4 捆绑提供。如果将捆绑提供的 Java FX 2.1 SDK 和运行时安装到默认位置,则 NetBeans IDE 可以自动创建启用 JavaFX 的 Java 平台。
- 对于 MacOS,JavaFX 2.1 嵌入在 Mac JDK 1.7 Update 4 中。NetBeans IDE 可以自动创建启用 JavaFX 的 Java 平台。
- 还可以单独从 JavaFX 下载站点安装 JavaFX 2.1。JavaFX 2.1 要求使用 Java JDK 1.6.0 Update 26 或更高版本或 Java 7。JavaFX 并非可在所有操作系统上运行。请检查“JavaFX 系统要求”文档,了解 JavaFX 所支持的平台。根据 JavaFX 2.1 的系统要求,您还需要安装 NetBeans IDE。
重要说明:要在 Mac 上使用 JavaFX 进行开发,需要 Mac JDK 7 Update 4、JavaFX 2.1(随 Mac JDK 7u4 捆绑提供)以及 NetBeans IDE 7.1.2 或更高版本。如果您具有 NetBeans IDE 7.1 或 7.1.1,请安装所有可用更新以升级到 NetBeans IDE 7.1.2。
注:在 Windows 上安装 JavaFX 2.1 时,实际上安装了两个程序包:JavaFX 2.1 SDK 和 JavaFX 2.1 运行时。
如果手动在 Windows 上安装 JavaFX 2.1,请考虑将 JavaFX 2.1 SDK 和运行时安装到默认位置 (C:/Program Files/Oracle/)。NetBeans IDE 会检查默认位置,看是否存在 JavaFX 2.1 SDK 和 JavaFX 2.1 运行时。如果 JavaFX 2 位于默认位置,则 NetBeans IDE 将自动创建启用 JavaFX 的 Java 平台。如果安装随 Java JDK 捆绑提供的 JavaFX 2.1,则 NetBeans 会查找 JavaFX 2.1 SDK 和运行时。
如果手动在 MacOS 上安装 JavaFX 2.1,则没有默认位置,必须手动创建启用 JavaFX 的 Java 平台。
升级 JavaFX 2
如果希望将 JavaFX 2 从一个版本升级到另一个版本(例如,从 JavaFX 2.0 到 JavaFX 2.1),则最安全的做法是卸载旧版本的 JavaFX 2。手动卸载旧版本并确保其目录已删除。JavaFX 安装程序并非总是正确卸载旧版本的 JavaFX 2,这可能会导致要使用的版本有误。
此外,如果新 FX SDK 位置与旧版本位置不同,有可能会出现问题。现有的默认启用 FX 的平台仍可能指向旧位置。在这种情况下,打开 "Tools"(工具)> "Java Platforms"(Java 平台)并删除旧版本的默认启用 FX 的平台。然后,使用 JavaFX 2 的更新版本创建新的默认启用 FX 的平台。
创建启用 JavaFX 的 Java 平台
NetBeans IDE 需要启用 JavaFX 2.1 的 Java 平台以便使用 JavaFX 2.1。此部分说明如何在 NetBeans IDE 中创建启用 JavaFX 2.1 的 Java 平台。
在启动新建 JavaFX 项目向导后或首次打开现有 JavaFX 项目时,NetBeans IDE 将尝试创建启用 JavaFX 的 Java 平台。如果 NetBeans IDE 无法自动创建启用 JavaFX 的 Java 平台,则会出现一条警告。在这种情况下,必须手动创建启用 JavaFX 的 Java 平台。您可以创建其他启用 JavaFX 的 Java 平台,例如,如果您希望这些平台使用不同的 Java JDK,则可以这样做。
在本节中,该过程分为两部分,分别反映自动和手动创建的平台:
- 打开新建 JavaFX 应用程序向导。这是通用的起点。打开该向导时,NetBeans IDE 尝试创建启用 JavaFX 的 Java 平台。如果 NetBeans 成功,则完成操作。
- 手动创建启用 JavaFX 的平台。如果自动平台生成操作失败,或者需要其他启用 JavaFX 的平台,则必须手动创建平台。
打开新建 JavaFX 应用程序向导
创建启用 JavaFX 的 Java 平台时,第一步是打开 NetBeans IDE 的新建 JavaFX 应用程序向导。(您也可以打开新建 JavaFX 预加载器向导。)如果 IDE 找不到启用 JavaFX 的 Java 平台,则会尝试生成启用 JavaFX 的 Java 平台。如果 IDE 成功生成启用 JavaFX 的 Java 平台,则设置完成。如果 IDE 未生成启用 JavaFX 的 Java 平台,则必须手动创建平台。
注:在 Windows 上自动生成平台时,JavaFX SDK 和运行时都会安装到默认位置 (C:\Program Files\Oracle\);在 MacOS 上,JavaFX SDK 嵌入到 Mac JDK 7u4 中。
打开新建 JavaFX 应用程序向导:
- 在 IDE 中,单击 "New Project"(新建项目)图标(或者 "File"(文件)> "New Project"(新建项目)或按 Ctrl-Shift-N 组合键)。此时将打开新建项目向导。

- 选择 "JavaFX" 类别。在 "Projects"(项目)下,选择 "JavaFX Application"(JavaFX 应用程序)。单击 "Next"(下一步)。"Name and Location"(名称和位置)面板打开。IDE 会查找 JavaFX SDK 并尝试生成启用 JavaFX 的 Java 平台。
现在将显示两个屏幕之一,这取决于 NetBeans IDE 是否生成了启用 JavaFX 的平台:
- 生成了平台:IDE 生成启用 JavaFX 的 Java 平台。默认情况下,此启用 JavaFX 的平台使用 IDE 所使用的相同 JDK 源。所生成平台的名称是 "Default Java FX Platform"。IDE 会自动选择此平台。除非您要使用不同的 JDK 创建其他启用 JavaFX 的 Java 平台,否则设置完成。现在,您就可以完成教程了。如果要创建其他启用 JavaFX 的 Java 平台,请参见手动创建启用 JavaFX 的平台。
- 未生成平台:"JavaFX Platform"(JavaFX 平台)列表不显示任何启用 JavaFX 的平台。面板底部会显示一条警告。转至手动创建启用 JavaFX 的平台。
手动创建启用 JavaFX 的平台
在以下情况中,您需要手动创建启用 JavaFX 的 Java 平台:
- 打开了新建 JavaFX 应用程序或新建 JavaFX 预加载器向导时,NetBeans IDE 无法生成启用 JavaFX 的 Java 平台。
- 默认情况下,所需的启用 JavaFX 的平台基于的 Java JDK 不同于 IDE 所使用的 JDK。例如,您的 IDE 使用的是 Java JDK 1.6.0 Update 27,但您需要使用 Java 7 构建 JavaFX 应用程序。
手动创建启用 JavaFX 的平台:
- 打开 NetBeans IDE Java 平台管理器。平台管理器可通过以下方式打开:
- 在新建 JavaFX 应用程序向导或新建 JavaFX 预加载器向导中,单击 "Manage Platforms..."(管理平台...)
- 展开 "Tools"(工具)菜单,然后选择 "Java Platforms"(Java 平台)。
- 打开 Java 项目的项目属性。转至 "Libraries"(库)页。单击 "Manage Platforms..."(管理平台...)
- 单击 "Add Platform..."(添加平台...)。此时将打开带有 "Choose Java Platform"(选择 Java 平台)面板的添加 Java 平台向导。浏览所需的 JDK。

- 选择 JDK。您必须选择 JDK 1.6 Update 26 或更高版本(或 JDK 7)。单击 "Next"(下一步)。"Platform Name"(平台名称)面板打开。

- 为新平台指定任意描述性名称,然后单击 "Finish"(完成)。您将返回平台管理器。此时将列出您所创建的平台。

- 选择您所创建的平台。针对该平台打开 "JavaFX" 标签。目前尚未针对此平台启用 JavaFX。勾选 "Enable JavaFX"(启用 JavaFX)框。此时将显示一条说明 JavaFX 平台无效的警告。
- 单击 "JavaFX SDK" 字段旁的 "Browse"(浏览)。浏览 "JavaFX 2.1 SDK" 文件夹。

- 单击 "Open"(打开)。您将返回 Java 平台管理器。现在 "JavaFX SDK" 和 "JavaFX Javadoc" 字段被填充。如果 JavaFX 运行时 2 与 JavaFX 2.1 SDK 位于同一目录中,则还填充 "JavaFX Runtime"(JavaFX 运行时)字段。如果 JavaFX 运行时与 SDK 位于不同目录中,则浏览该运行时。"Sources"(源)字段中不需要填充任何内容。
如果您已有了 "JavaFX 2.1 SDK"、"JavaFX Javadoc" 和 "JavaFX Runtime"(JavaFX 运行时)字段的值,并且没有显示 JavaFX 平台无效的警告,请单击 "Close"(关闭)。此时,启用 JavaFX 的平台就已完成。

- 如果返回或打开新建 JavaFX 应用程序向导,则需要选择您所创建的启用 JavaFX 的平台。从 "JavaFX Platform"(JavaFX 平台)列表中选择您所创建的启用 JavaFX 2.1 的平台。如果出现的警告说明选定的 Java 平台不支持 JavaFX,则该警告会消失。
您可以通过单击 "Finish"(完成)来创建项目,也可以单击 "Cancel"(取消)。即使取消新建项目向导,新平台也依然存在。
教程
将 NetBeans IDE 设置为使用 JavaFX 2.1 后,尝试以 NetBeans 项目的方式完成 JavaFX 教程。
疑难解答
- 我收到了 JavaFX 运行时已过时的警告。您是否曾安装过 JavaFX 2 的较早版本?安装程序可能未正确卸载旧的运行时。解决办法:手动卸载 JavaFX 2 的所有较早版本。请务必删除卸载后一直保留的所有目录。
- 我遇到了本文档中没有描述过的其他问题!如果您认为本文档内容有遗漏,请单击“本教程”链接下的“发送反馈”,向作者说明情况。如果您认为自己发现了 NetBeans IDE 对 JavaFX 2 的支持存在错误,请报告该错误。在 "enter_bug.cgi" 页上,选择 javafx 产品。
返回至学习资源