使用 Ivy 为 javadoc 指定 Web URL

Question

===更新=== 我将尝试重新措辞以引起更多回应。 Ivy 中的 javadoc 工件是否 必须 是 jar 或 zip 文件？或者我可以将工件定义为类似于http://download.oracle.com/javase/1.5.0/docs/api/ 的 URL？

我知道您可以将 Ivy 工件定义为从中下载文件的 url，但这不是我想要做的。

===原创===

我正在使用 Ivy 来处理由多个 Java 项目组成的大型项目的依赖关系管理。每个项目都由 Hudson 服务器编译并发布到 Ivy。每个项目都构建它的运行时 jar、源 jar 和 javadoc jar。此外，Hudson 将 Javadoc 发布到 Web 服务器上的 URL。

我想要做的是在我的 ivy.xml 中为 Javadoc 在某个 URL 上发布的每个项目指定。在我的依赖项目中，我想让 Ivy 解决该依赖关系并将其提供给 ant 中的 javadoc 命令作为子任务的参数。

最后，我想要以下内容：项目 A 在 http://someurl/A/javadoc 发布了 javadoc 项目 B 依赖于 A，它的 javadoc 发布在 http://someurl/B/javadoc 在项目 B 的 javadoc 中使用项目 A 中的类，我希望它链接到项目 A url。

想法？

Answer 1

我想要做的是在我的 每个项目的 ivy.xml Javadoc 在某个 URL 上发布。

我猜你应该像任何其他工件一样发布 Javadoc，并在 ivysettings.xml 中指定搜索模式。示例：

<resolvers>
  <url name="repository">
    <ivy pattern="${repository.url}/[module]/ivy-[revision].xml" />
    <artifact pattern="${repository.url}/[module]/[artifact]-[revision].[ext]" />
    <artifact pattern="${repository.url}/[module]/[artifact]-javadoc-[revision].[ext]" />
  </filesystem>
</resolvers>

最后，我想要以下内容： 项目 A 的 javadoc 发布在 http://someurl/A/javadoc 项目 B 是 依赖于 A 并且它的 javadoc 是 发表于http://someurl/B/javadoc 在项目 B 的 javadoc 中使用 来自项目 A 的课程，我想要它 链接到项目 A 的 url。

只要您将 Javadoc 作为工件发布，它就有自己的 ivy.xml，您可以在此处声明依赖关系：

<ivy-module version="2.0">
    <info organisation="yourorg" module="moduleB-javadoc" />
    <dependencies>
        <dependency org="yourorg" name="moduleA-javadoc" />
    </dependencies>
</ivy-module>

在我的依赖项目中，我想 让 Ivy 解决这种依赖关系并 将其提供给 ant 中的 javadoc 命令 作为子任务的参数。

将 javadoc 工件描述为依赖项目的 ivy.xml 中的依赖项，然后在 build.xml 中指定 ant javadoc 任务依赖于根据需要执行和操作 javadoc jar 的目标（有关详细信息，请参阅 ant 文档）。