有什么方法可以在 Eclipse 中为非 JRE 包自动化 Javadoc 附件吗？

Question

首先，这与 Java SE Java 文档无关。一切正常。

我们有一个基于 Java 的大型平台，大约有 20 个 API 包。对于使用我们平台的人，我们希望工具提示和其他此类内置文档支持能够像 Java APIs.

那样工作

我们的 Java 文档 URL 可供使用我们平台的人使用，并且在使用通常的方法手动附加到引用的包时可以正常工作。

Eclipse 似乎不会保留 Javadoc 附件 - 也就是说，当您将 Javadocs 附加到一个包时，它可以工作，但是当您重新启动 Eclipse 时，该附件会丢失.

至少有 20 个 API 包，并且使用我们平台的典型工作区至少有 10 个或更多项目，必须手动将 Javadocs 附加到每个项目的每个引用包不是每次重新启动 Eclipse 时可行（例如，可以是 200 个手动附件）。

有什么方法可以让它自动化吗？我不在某种脚本解决方案之上，即使每次启动 Eclipse 时它都必须是运行，但很明显，如果只是 "worked" 会更好，就像它为Java API秒。（就此而言，我希望它也适用于 Apache Commons、Bouncy Castle、Android 等各种东西）。

谢谢...

Answer 1

这个问题可以通过为您的目标平台提供一个包含 Javadoc 的包来解决（不包括源代码）。以下是实现此目的的步骤：

创建包含您 API
在此插件中通过 org.eclipse.pde.core.javadoc extension point 定义扩展，如下所示：

<extension point="org.eclipse.pde.core.javadoc">
    <javadoc path="javadoc"> <!-- relative path to the API javadoc directory (can also be a URL) -->
        <plugin id="com.acme.core"/>
        <plugin id="com.acme.ui"/>
        <!-- list plug-ins which have been documented in the docs -->
    </javadoc>
</extension>

导出此插件并将其添加到目标平台

如果您的 Javadoc 已通过 URL 在线提供，您只需创建定义扩展的插件并将 URL 设置为 Javadoc 元素的路径：

<javadoc path="https://acme.com/apidocs">

Eclipse IDE 将通过包的 PDE 扩展自动解析 Javadoc 位置。

有什么方法可以在 Eclipse 中为非 JRE 包自动化 Javadoc 附件吗？

Is there any way to automate Javadoc attachment for non-JRE bundles in Eclipse?

java

eclipse

javadoc

eclipse-plugin