如何强制IntelliJ使用Maven下载Java文档?

75

我在Project Structure中为一些Maven条目编写了以下描述:

输入图像描述

Javadoc文件确实不存在于文件系统中。与此同时,它存在于中央仓库中。为什么它没有被下载,如何强制下载?

更新

这些选项已经打开了:

输入图像描述

设置完它们后,尝试重新编译、关闭/打开等操作,但问题仍未解决...


1
嗯...下载Java文档是必要的吗?使用Eclipse这个IDE,它本身就能够提取和格式化源代码中嵌入的javadoc注释。 - Stephen C
1
这是一个复杂的问题,我正在调查。是的,Idea也能够显示从代码实时生成的javadocs。 - Dims
4
文件 -> 设置 -> 构建,执行,部署 -> 构建工具 -> Maven -> 导入,勾选下载源码和/或文档的框。请参阅https://www.jetbrains.com/idea/help/editing-maven-settings.html,https://www.jetbrains.com/idea/help/maven-2.html和https://www.jetbrains.com/idea/help/maven-importing.html。 - M. Deinum
@M.Deinum,抱歉忘了提醒您,我已经打开了这些框。 - Dims
一个相关问题:在IntelliJ中为仅一个Maven依赖项下载文档 - Basil Bourque
4个回答

130
点击IntelliJ右侧的“maven项目”(确保工具按钮已打开),然后点击“下载文档”。
另外,为了以后下载,您可以进入文件->设置->构建、执行、部署->构建工具->Maven->导入->勾选“文档”复选框并应用设置。

抱歉,请问“Intelij 的右侧”是什么?我在右上方有一个小工具栏,其中包括“制作项目”、“运行”、“调试”等几个按钮,但没有任何关于文档的选项... - Dims
可能发生的情况是 mvn 仓库(构建、执行、部署 > 构建工具 > Maven > 仓库)没有被更新。原因可能各不相同。在我的情况下,这些仓库的密码过期了(在我的情况下,是项目特定的 settings.xml 文件)。修复后,我点击 IDEA 的仓库列表中的 "更新",它们就会被下载。注意:要检查 javadoc 是否已经下载,您可以检查您的 mvn 仓库(通常位于 ~/.m2/repository)中是否存在 *-javadoc.jar 文件。 - gicig

81

Maven项目面板

Maven项目工具窗口 > 绿色箭头和方框图标 > 下载文档:

输入图片描述

请参阅IntelliJ IDEA文档,了解14.1版本当前版本的详细信息。


5
这个方法有用吗?我尝试了多次,它只是执行了一下,但当它完成后,我仍然无法在打开依赖源文件时看到Java文档,即使是像LocalTime这样的JDK类也只能看到源代码,没有Java文档。 - Samuel Owino
IntelliJ 2019.3.1 - Samuel Owino
1
这样做的缺点是,IntelliJ(不是智能地)将开始下载项目中每个依赖项的文档,而不仅仅是您感兴趣的那些(Netbeans在这些方面是无价的)。 - FiruzzZ

1
顺便说一下,如果您遇到与我相同的情况(使用公司Maven存储库),则Maven可能会忽略进一步下载javadoc的机会,如果它曾经不存在。为了再次请求它,您必须从.m2/repository/<groupId>/<artifactId>/<version>中删除<artifactId>-<version>-javadoc.jar.lastUpdated文件,然后重试。

0
对我来说,当我点击“下载源代码和文档”时,它可以正常工作。

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接