时间戳

首页 > 解决方案 > Gradle javadoc 搜索重定向到“/undefined/..” URL

gradle - Gradle javadoc 搜索重定向到“/undefined/..” URL

问题描述

我正在使用 Java 11 和 gradle 为不使用以下配置的模块的项目生成 javadoc。

文档生成正确，但导航到搜索结果会产生未找到的文件而不是预期的页面。在包和类名之前的 URL 中有一个额外的“undefined/”（例如“.../doc/undefined/package/Class.html”）。

对于 Maven 的 javadoc有一个类似的问题，但我看不到如何--no-module-directories在 gradle 中添加该选项。

task allJavadoc (type: Javadoc, description: 'Generate javadoc from all projects', group: 'Documentation') {
    destinationDir = file("$projectDir/doc")
    title = "Title"
    maxMemory = "2048m"
    failOnError true
    options.author false
    options.version true
    options.use true
    options.links "https://docs.oracle.com/en/java/javase/11/docs/api/"
    options.breakIterator true

    subprojects.each { proj ->
        proj.tasks.withType(Javadoc).each { javadocTask ->
            classpath += javadocTask.classpath
            excludes += javadocTask.excludes
            includes += "**/*.java"
        }
    }
}

标签： gradlejavadoc

解决方案

您需要添加一个删除前导连字符的布尔选项：

options.addBooleanOption "-no-module-directories", true

推荐阅读