有没有办法在Eclipse中为非JRE捆绑包自动化Javadoc附件?

有没有办法在Eclipse中为非JRE捆绑包自动化Javadoc附件?,java,eclipse,eclipse-plugin,javadoc,Java,Eclipse,Eclipse Plugin,Javadoc,首先,这与JavaSE Javadocs无关。那很好 我们有一个基于Java的大型平台,大约有20个API包。对于使用我们平台的用户,我们希望工具提示和其他类似的内置文档支持能够像Java API一样工作 我们的javadoc位于一个URL上,可供使用我们平台的用户使用,并且在使用常规方法手动附加到引用包时可以正常工作 Eclipse似乎没有持久化Javadoc附件——也就是说,当您将Javadoc附加到捆绑包时,它可以工作,但是当您重新启动Eclipse时,该附件将丢失 由于至少有20个API

首先,这与JavaSE Javadocs无关。那很好

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

我们的javadoc位于一个URL上,可供使用我们平台的用户使用,并且在使用常规方法手动附加到引用包时可以正常工作

Eclipse似乎没有持久化Javadoc附件——也就是说,当您将Javadoc附加到捆绑包时,它可以工作,但是当您重新启动Eclipse时,该附件将丢失

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

有没有办法让这个过程自动化?我并没有超越某种脚本解决方案,即使它必须在每次Eclipse启动时运行,但很明显,如果它能像JavaAPI那样“工作”就更好了。(就这一点而言,我希望它也适用于各种各样的东西,如Apache Commons、Bouncy Castle、Android等)


谢谢…

这个问题可以通过在目标平台上提供包含Javadoc的包来解决(不包括源代码)。以下是实现这一目标的步骤:

  • 创建包含API完整Javadoc的插件
  • 在此插件中定义扩展via,如下所示:
  • 
    
  • 导出此插件并将其添加到目标平台
  • 如果您的Javadoc已经通过URL在线可用,您只需创建定义扩展的插件,并将URL设置为Javadoc元素的路径:

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

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

    这是普通Java项目、Maven项目还是Gradle项目?@howlger,我们平台的典型用户不使用Maven或Gradle。在Eclipse中,我们提供平台捆绑包,并使用目标定义使这些捆绑包可用于工作区中的项目。Eclipse的方法是拥有源代码包/插件(.我从来没有听说过Javadoc捆绑包/插件。只包含公共API而没有内部代码的源捆绑包/插件对您来说是一个解决方案吗?如果目标平台包含源捆绑包/插件,Javadoc和源代码将自动显示。@howlger,这可能会起作用,但显然不太理想。我会仔细研究它-请随意将其作为一个答案发布,我会在测试后标记它。谢谢。这将是Bundle DocURL头的一个有趣的用法,尽管我认为它应该更通用。哇!工作起来像一个champ。非常感谢-这正是我要找的。Eclipse PDE不识别任何扩展原因是,但是如果我构建插件并将其添加到一个项目中,它将非常有效。
    <javadoc path="https://acme.com/apidocs">