| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| <!-- |
| Copyright (c) 2011 Oracle and/or its affiliates. All rights reserved. |
| --> |
| <html> |
| <head> |
| <title>带 JavaFX 2.1 的 NetBeans IDE</title> |
| <meta name="KEYWORDS" content="NETBEANS, JAVAFX"> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <meta name="DESCRIPTION" content="How to set up NetBeans IDE to use with JavaFX 2.1 when the two are installed separately" > |
| <link rel="stylesheet" type="text/css" href="../../../netbeans.css" media="screen"></head> |
| <body> |
| <h1>带 JavaFX 2.1 的 NetBeans IDE</h1> |
| <p>JavaFX 提供了一个基于 Java 的强大 UI 平台，可用于处理大型数据驱动业务应用程序。JavaFX 2 是 JavaFX 平台的主要更新版。从此版本开始，开发者可以完全使用 Java 创建 JavaFX 应用程序。 </p> |
| <p>NetBeans IDE 支持创建 JavaFX 2 应用程序。</p> |
| <p><b>目录</b></p> |
| <p><img alt="此页上的内容适用于 NetBeans IDE 7.1" class="stamp" height="114" src="../../../images_www/articles/71/netbeans-stamp-71-72.gif" title="此页上的内容适用于 NetBeans IDE 7.1" width="114"></p> |
| <ul> |
| <li><a href="#installing">安装 NetBeans IDE 和 JavaFX 2.1 SDK</a> </li> |
| <li><a href="#upgrade">升级 JavaFX 2</a></li> |
| <li><a href="#create-platform">创建启用 JavaFX 的 Java 平台</a> |
| <ul> |
| <li><a href="#open-newapp-wiz">打开新建 JavaFX 应用程序向导</a></li> |
| <li><a href="#create-platform-manual">手动创建启用 JavaFX 的平台</a></li> |
| </ul> |
| </li> |
| <li><a href="#tutorials">教程</a></li> |
| <li><a href="#troubleshooting">疑难解答</a></li> |
| </ul> |
| |
| <p><b>要学习本教程，您需要具备以下软件和资源。</b></p> |
| <table> |
| <tbody> |
| <tr> |
| <th width="208" class="tblheader" scope="col">软件或资源</th> |
| <th width="218" class="tblheader" scope="col">要求的版本</th> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="https://netbeans.org/downloads/index.html" target="_blank">NetBeans IDE</a></td> |
| <td class="tbltd1">7.1.2 Java SE、Java EE 或全部</td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javafx/downloads/index.html" target="_blank">JavaFX 2.1 SDK</a></td> |
| <td class="tbltd1">最新发行版本 |
| </tr> |
| </tbody> |
| </table> |
| |
| |
| |
| |
| |
| <h2><a name="installing"></a>安装 NetBeans IDE 和 JavaFX 2.1 SDK</h2> |
| |
| <p>如果操作系统允许，您可以安装 Java JDK 捆绑提供的 JavaFX 2.1。否则，必须单独安装 JavaFX 2.1。</p> |
| <ul> |
| <li>对于 Windows，JavaFX 2.1 随 JDK 1.7 Update 4 捆绑提供。如果将捆绑提供的 Java FX 2.1 SDK 和运行时安装到默认位置，则 NetBeans IDE 可以自动<a href="#create-platform">创建启用 JavaFX 的 Java 平台</a>。</li> |
| <li>对于 MacOS，JavaFX 2.1 嵌入在 Mac JDK 1.7 Update 4 中。NetBeans IDE 可以自动<a href="#create-platform">创建启用 JavaFX 的 Java 平台</a>。</li> |
| <li>还可以单独从 <a href="http://www.oracle.com/technetwork/java/javafx/downloads/index.html" target="_blank">JavaFX 下载站点</a>安装 JavaFX 2.1。JavaFX 2.1 要求使用 Java JDK 1.6.0 Update 26 或更高版本或 Java 7。JavaFX 并非可在所有操作系统上运行。请检查<a href="http://download.oracle.com/javafx/2/system_requirements/jfxpub-system_requirements.htm" target="_blank">“JavaFX 系统要求”文档</a>，了解 JavaFX 所支持的平台。根据 JavaFX 2.1 的系统要求，您还需要安装 NetBeans IDE。</li> |
| </ul> |
| <p class="alert"><strong>重要说明：</strong>要在 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。</p> |
| <p class="notes"><strong>注：</strong>在 Windows 上安装 JavaFX 2.1 时，实际上安装了两个程序包：JavaFX 2.1 SDK 和 JavaFX 2.1 运行时。</p> |
| <p>如果手动在 Windows 上安装 JavaFX 2.1，请考虑将 JavaFX 2.1 SDK 和运行时安装到默认位置 (<tt>C:/Program Files/Oracle/</tt>)。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 和运行时。</p> |
| <p>如果手动在 MacOS 上安装 JavaFX 2.1，则没有默认位置，必须手动<a href="#create-platform">创建启用 JavaFX 的 Java 平台</a>。</p> |
| <h2 id="upgrade">升级 JavaFX 2</h2> |
| <p>如果希望将 JavaFX 2 从一个版本升级到另一个版本（例如，从 JavaFX 2.0 到 JavaFX 2.1），则最安全的做法是卸载旧版本的 JavaFX 2。<span class="alert">手动卸载旧版本并确保其目录已删除。JavaFX 安装程序并非总是正确卸载旧版本的 JavaFX 2，这可能会导致要使用的版本有误。 </span></p> |
| <p>此外，如果新 FX SDK 位置与旧版本位置不同，有可能会出现问题。现有的默认启用 FX 的平台仍可能指向旧位置。在这种情况下，打开 "Tools"（工具）> "Java Platforms"（Java 平台）并删除旧版本的默认启用 FX 的平台。然后，使用 JavaFX 2 的更新版本<a href="#create-platform">创建新的默认启用 FX 的平台</a>。</p> |
| <h2><a name="create-platform"></a>创建启用 JavaFX 的 Java 平台</h2> |
| <p>NetBeans IDE 需要启用 JavaFX 2.1 的 Java 平台以便使用 JavaFX 2.1。此部分说明如何在 NetBeans IDE 中创建启用 JavaFX 2.1 的 Java 平台。</p> |
| <p>在启动新建 JavaFX 项目向导后或首次打开现有 JavaFX 项目时，NetBeans IDE 将尝试创建启用 JavaFX 的 Java 平台。如果 NetBeans IDE 无法自动创建启用 JavaFX 的 Java 平台，则会出现一条警告。在这种情况下，必须手动创建启用 JavaFX 的 Java 平台。您可以创建其他启用 JavaFX 的 Java 平台，例如，如果您希望这些平台使用不同的 Java JDK，则可以这样做。</p> |
| <p>在本节中，该过程分为两部分，分别反映自动和手动创建的平台：</p> |
| <ul> |
| <li><strong>打开新建 JavaFX 应用程序向导。</strong>这是通用的起点。打开该向导时，NetBeans IDE 尝试创建启用 JavaFX 的 Java 平台。如果 NetBeans 成功，则完成操作。 </li> |
| <li><strong>手动创建启用 JavaFX 的平台。</strong>如果自动平台生成操作失败，或者需要其他启用 JavaFX 的平台，则必须手动创建平台。</li> |
| </ul> |
| <div class="indent"> |
| <h3><a name="open-newapp-wiz"></a>打开新建 JavaFX 应用程序向导</h3> |
| <p>创建启用 JavaFX 的 Java 平台时，第一步是打开 NetBeans IDE 的新建 JavaFX 应用程序向导。（您也可以打开新建 JavaFX 预加载器向导。）如果 IDE 找不到启用 JavaFX 的 Java 平台，则会尝试生成启用 JavaFX 的 Java 平台。如果 IDE 成功生成启用 JavaFX 的 Java 平台，则设置完成。如果 IDE 未生成启用 JavaFX 的 Java 平台，则必须手动创建平台。</p> |
| <p class="notes"><b>注：</b>在 Windows 上自动生成平台时，JavaFX SDK 和运行时都会安装到默认位置 (<tt>C:\Program Files\Oracle\</tt>)；在 MacOS 上，JavaFX SDK 嵌入到 Mac JDK 7u4 中。</p> |
| <p><strong>打开新建 JavaFX 应用程序向导：</strong></p> |
| <ol> |
| <li>在 IDE 中，单击 "New Project"（新建项目）图标（或者 "File"（文件）> "New Project"（新建项目）或按 Ctrl-Shift-N 组合键）。此时将打开新建项目向导。<br><img alt=""New Project"（新建项目）窗口的第一个面板，JavaFX 应用程序已选定" class="margin-around" height="434" src="../../../images_www/articles/72/java/javafx-setup/new-project.png" width="600"></li> |
| <li>选择 "JavaFX" 类别。在 "Projects"（项目）下，选择 "JavaFX Application"（JavaFX 应用程序）。单击 "Next"（下一步）。"Name and Location"（名称和位置）面板打开。IDE 会查找 JavaFX SDK 并尝试生成启用 JavaFX 的 Java 平台。 </li></ol> |
| <p>现在将显示两个屏幕之一，这取决于 NetBeans IDE 是否生成了启用 JavaFX 的平台：</p> |
| <ul> |
| <li><b>生成了平台：</b>IDE 生成启用 JavaFX 的 Java 平台。默认情况下，此启用 JavaFX 的平台使用 IDE 所使用的相同 JDK 源。所生成平台的名称是 "Default Java FX Platform"。IDE 会自动选择此平台。除非您要使用不同的 JDK 创建其他启用 JavaFX 的 Java 平台，否则设置完成。现在，您就可以完成<a href="#tutorials">教程</a>了。如果要创建其他启用 JavaFX 的 Java 平台，请参见<a href="#create-platform-manual">手动创建启用 JavaFX 的平台</a>。<br> <img alt="显示自动生成平台的新建 JavaFX 应用程序向导" class="margin-around" height="496" src="../../../images_www/articles/72/java/javafx-setup/newproject-autogen-platform.png" width="600"> </li> |
| <li><strong>未生成平台：</strong>"JavaFX Platform"（JavaFX 平台）列表不显示任何启用 JavaFX 的平台。面板底部会显示一条警告。转至<a href="#create-platform-manual">手动创建启用 JavaFX 的平台</a>。<br> <img alt="新建项目向导的 "Name and Location"（名称和位置）面板，选定了未启用 JavaFX 的 Java 平台" class="margin-around" height="501" src="../../../images_www/articles/71/java/javafx-setup/newproject-nofx.png" width="578"> </li> |
| </ul> |
| <h3><a name="create-platform-manual"></a>手动创建启用 JavaFX 的平台</h3> |
| <p>在以下情况中，您需要手动创建启用 JavaFX 的 Java 平台：</p> |
| <ul> |
| <li><a href="#open-newapp-wiz">打开了新建 JavaFX 应用程序</a>或新建 JavaFX 预加载器向导时，NetBeans IDE 无法生成启用 JavaFX 的 Java 平台。</li> |
| <li>默认情况下，所需的启用 JavaFX 的平台基于的 Java JDK 不同于 IDE 所使用的 JDK。例如，您的 IDE 使用的是 Java JDK 1.6.0 Update 27，但您需要使用 Java 7 构建 JavaFX 应用程序。 </li> |
| </ul> |
| <p><strong>手动创建启用 JavaFX 的平台：</strong></p> |
| <ol> |
| <li>打开 NetBeans IDE Java 平台管理器。平台管理器可通过以下方式打开： |
| <ul> |
| <li>在新建 JavaFX 应用程序向导或新建 JavaFX 预加载器向导中，单击 "Manage Platforms..."（管理平台...）</li> |
| <li>展开 "Tools"（工具）菜单，然后选择 "Java Platforms"（Java 平台）。</li> |
| <li>打开 Java 项目的项目属性。转至 "Libraries"（库）页。单击 "Manage Platforms..."（管理平台...） </li> |
| </ul> |
| </li> |
| <li>单击 "Add Platform..."（添加平台...）。此时将打开带有 "Choose Java Platform"（选择 Java 平台）面板的添加 Java 平台向导。浏览所需的 JDK。<br> <img alt="选择添加 Java 平台向导的 "Java Platform"（Java 平台）面板，其中显示可用平台" class="margin-around" height="448" src="../../../images_www/articles/71/java/javafx-setup/addplatform.png" width="551"></li> |
| <li>选择 JDK。您必须选择 JDK 1.6 Update 26 或更高版本（或 JDK 7）。单击 "Next"（下一步）。"Platform Name"（平台名称）面板打开。<br> <img alt="添加 Java 平台向导的 "Platform Name"（平台名称）面板" class="margin-around" height="292" src="../../../images_www/articles/71/java/javafx-setup/platform-name.png" width="560"></li> |
| <li>为新平台指定任意描述性名称，然后单击 "Finish"（完成）。您将返回平台管理器。此时将列出您所创建的平台。<br> <img alt="显示新平台的平台管理器" class="margin-around" height="462" src="../../../images_www/articles/71/java/javafx-setup/platform-mgr-newplatform-nofx.png" width="600"></li> |
| <li>选择您所创建的平台。针对该平台打开 "JavaFX" 标签。目前尚未针对此平台启用 JavaFX。勾选 "Enable JavaFX"（启用 JavaFX）框。此时将显示一条说明 JavaFX 平台无效的警告。</li> |
| <li>单击 "JavaFX SDK" 字段旁的 "Browse"（浏览）。浏览 "JavaFX 2.1 SDK" 文件夹。<br> <img alt="浏览 JavaFX 2.1 SDK" class="margin-around" height="340" src="../../../images_www/articles/71/java/javafx-setup/sdk-location.png" width="498"></li> |
| <li>单击 "Open"（打开）。您将返回 Java 平台管理器。现在 "JavaFX SDK" 和 "JavaFX Javadoc" 字段被填充。如果 JavaFX 运行时 2 与 JavaFX 2.1 SDK 位于同一目录中，则还填充 "JavaFX Runtime"（JavaFX 运行时）字段。如果 JavaFX 运行时与 SDK 位于不同目录中，则浏览该运行时。"Sources"（源）字段中不需要填充任何内容。 |
| <p>如果您已有了 "JavaFX 2.1 SDK"、"JavaFX Javadoc" 和 "JavaFX Runtime"（JavaFX 运行时）字段的值，并且没有显示 JavaFX 平台无效的警告，请单击 "Close"（关闭）。此时，启用 JavaFX 的平台就已完成。<br> <img alt="显示有效 JavaFX 2.1 目录的已完成 Java 平台管理器" class="margin-around" height="408" src="../../../images_www/articles/71/java/javafx-setup/platform-mgr-withfx.png" width="600"></p> |
| </li> |
| <li>如果返回或打开新建 JavaFX 应用程序向导，则需要选择您所创建的启用 JavaFX 的平台。从 "JavaFX Platform"（JavaFX 平台）列表中选择您所创建的启用 JavaFX 2.1 的平台。如果出现的警告说明选定的 Java 平台不支持 JavaFX，则该警告会消失。<br> <img alt="新建 JavaFX 应用程序向导，选定了手动创建的 JavaFX 平台" class="margin-around" height="496" src="../../../images_www/articles/72/java/javafx-setup/new-project-withfx.png" width="600"> |
| <p> 您可以通过单击 "Finish"（完成）来创建项目，也可以单击 "Cancel"（取消）。即使取消新建项目向导，新平台也依然存在。</p> |
| </li> |
| </ol> |
| </div> |
| <h2><a name="tutorials"></a>教程</h2> |
| <p>将 NetBeans IDE 设置为使用 JavaFX 2.1 后，尝试以 NetBeans 项目的方式完成 <a href="http://download.oracle.com/javafx/" target="_blank">JavaFX 教程</a>。</p> |
| <h2><a name="troubleshooting"></a>疑难解答</h2> |
| <ul> |
| <li><strong>我收到了 JavaFX 运行时已过时的警告。</strong>您是否曾安装过 JavaFX 2 的较早版本？安装程序可能未正确卸载旧的运行时。<strong>解决办法：</strong>手动卸载 JavaFX 2 的所有较早版本。请务必删除卸载后一直保留的所有目录。</li> |
| |
| <li><strong>我遇到了本文档中没有描述过的其他问题！</strong>如果您认为本文档内容有遗漏，请单击“本教程”链接下的“发送反馈”，向作者说明情况。如果您认为自己发现了 NetBeans IDE 对 JavaFX 2 的支持存在错误，请<a href="https://netbeans.org/community/issues.html">报告该错误</a>。在 "enter_bug.cgi" 页上，选择 javafx 产品。</li> |
| </ul> |
| <div class="feedback-box" ><a href="/about/contact_form.html?to=3&subject=Feedback:%20JavaFX%20Setup">发送有关此教程的反馈意见</a></div> |
| <br style="clear:both;" /> |
| |
| <p><a href="../../trails/matisse.html">返回至学习资源</a></p> |
| </body> |
| </html> |
