首页 > 解决方案 > 无法使用 gradle 将 package.html 放入 javadoc

问题描述

我在每个源目录中都有 package.html 文件,这在过去有效。我不确定这是由于新版本的 Java 还是新版本的 Gradle,但现在不再包含包信息。注意:该项目的overview.html 已包含在内。这是 build.gradle 的相关部分:

task doc (type: Javadoc) {
  source = sourceSets.main.allJava
  classpath = configurations.compile
  options.overview = "src/overview.html"
}

这类似于Can't get overview.html into javadoc with gradle

我正在使用 Gradle 版本 5.6.3 和 Java 版本 11.0.2

标签: gradlejavadoc

解决方案


我只是用 package-info.java 替换了 package.html,现在它可以工作了。这不是一个很好的解决方案,因为我找不到任何证据表明 package.html 方法已被弃用 - 所以它应该可以工作。我已经升级了用于构建项目的 Java 和 Gradle 版本,但这曾经在 Java 8 和 Gradle 4 上工作过。哦,好吧。我猜这就是进步。


推荐阅读