Netbeans 10(使用 Maven)中的 JavaFX 11 没有 Sources/Javadocs

JavaFX 11 in Netbeans 10 (with Maven) has no Sources/Javadocs

我试用了 JavaFX tutorial for Netbeans with Maven 并且 运行 没问题。 Maven 找到工件,下载它们,构建项目并启动它。但是我没有完成代码(缺少源代码和 Javadoc)。

我尝试下载 Netbeans 中 Maven 依赖项的源代码和 javadoc,但只有 sources/javadocs 包装器工件(例如空的 javafx-controls-11)可用。但是没有找到实际实现的来源(例如 javafx-controls-11-linux)。

在哪里可以找到 sources/javadocs 以及如何将它们添加到 Netbeans?

在 OpenJFX 文档中已经 issue 提交了关于此的文档。

虽然尚未解决,但有一个可能的解决方法,基于:

NetBeans only adds javadoc/source jars for a jar with the exact same name and -javadoc/-source suffix

所以这里是解决它的步骤:

  • 安装 NetBeans 10 and JDK 11.0.2.

  • 从 OpenJFX 示例中为 NetBeans 和 Maven 克隆 HelloFX sample

  • 将 JavaFX 依赖项更新到 11.0.2。

    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>11.0.2</version>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-fxml</artifactId>
        <version>11.0.2</version>
    </dependency>
    
  • 运行它:

    mvn clean compile exec:java
    
  • 检查 JavaFX 依赖项是否已下载到您的本地 m2 存储库。例如,在 <user home>/.m2/repository/org/openjfx/javafx-base/11.0.2 下,您会找到 javafx-base-11.0.2.jarjavafx-base-mac-11.0.2.jar(或 win,或 linux,具体取决于您的平台)。

  • 返回 NetBeans,右键单击 Dependencies 文件夹和 select Download Sources(查看右下方任务栏中的任务进度),然后 Download Javadoc (查看任务进度)

  • 转到您的 m2 存储库并确认现在有 -source-javadoc jar 文件。

但是,这还不能解决问题,还有一个额外的步骤:

  • 在您的 m2 存储库中,使用您的平台分类器手动将 -source-javadoc jar 文件重命名为 -mac-source-mac-javadoc(或 win,或 linux,具体取决于您的平台)。对不同的 JavaFX 模块执行此操作:

返回 NetBeans,检查您现在是否拥有 JavaDoc,或者如果您按 Ctrl/CMD+单击您可以访问源代码。

请注意,此修复只需执行一次,其余的 Maven 项目应选择 JavaDoc 和 Sources。