如何包含和链接到外部 javadocs

Question

我目前正在为一个严重依赖一些外部库（如番石榴）的项目生成 javadocs。所有依赖项都列在 pom.xml 中，为了避免每次更改库版本时都必须手动更新链接，我想为我们所有的依赖项生成/下载 javadocs 并链接到 javadocs 的本地版本项目的 javadocs 中的外部库。

我见过<offlineLinks>，但我认为这不能解决整个问题，但很可能我在这里遗漏了一些东西。

任何帮助将不胜感激！

Answer 1

尝试在您的 javadoc 配置中使用 <links>。你可以找到更多关于如何使用它的文档here

需要注意的几点：

1. 对我来说，外部链接仅适用于 maven-javadoc-plugin 版本 3.1.0 而不适用于 3.0.1
2. 所有外部链接都应该有一个可下载的package-list 文件，即如果您添加了一个链接https://example.com/apidocs/，那么应该有一个可在https://example.com/apidocs/package-list 下载的文件