Dokka - 跳过为默认 android 包生成 javadoc

Question

我正在尝试使用 Dokka 插件为 android Kotlin 应用程序生成 Javadoc。我将插件添加到我的 gradle:

classpath "org.jetbrains.dokka:dokka-gradle-plugin:0.9.15"

然后我按照项目说明进行了基本配置：

dokka {
    outputFormat = 'javadoc'
    outputDirectory = "$rootDir/docs"
    skipEmptyPackages = true
    noStdlibLink = true
}

我使用基本 gradle 命令生成文档：

[user@linux AppDir]$ bash gradlew dokka

输出很好，但它包含来自 android 的多个目录或我添加到项目中的插件，例如：

android.R
android.support
com.google
com.crashlytics
.
.
.
etc.

如何跳过这些包？有什么方法可以只为我的 /app/scr/java 文件夹和我创建的文件生成停靠栏吗？感谢任何帮助。

Answer 1

Dokka 0.9.16 版将包含 bugfix to remove generated files from documentation.

在版本 0.9.15 中，以下提交似乎解决了“Suppress output of android.R and other generated stuff in dokka-android”，但显然在使用所需信息创建 suppresedFiles 映射后，它并没有真正用于过滤 sourceSets.

更新：Dokka 0.9.16 has been released 修复，以及其他改进。

#224 Filtered out Android generated classes from docs

Answer 2

这是一个使用 Dokka 0.9.16 的工作示例：

task dokka(overwrite: true, type: org.jetbrains.dokka.gradle.DokkaAndroidTask) {
    outputFormat = 'javadoc'
    outputDirectory = "$buildDir/docs"

    // Do not create index pages for empty packages
    skipEmptyPackages = true

    //Do not output deprecated members. Applies globally, can be overridden by packageOptions
    skipDeprecated = false

    //No default documentation link to kotlin-stdlib
    noStdlibLink = false
}

如果您使用 Android 那么类型很重要：org.jetbrains.dokka.gradle.DokkaAndroidTask

不是DokkaTask而是DokkaAndroidTask.

Dokka - 跳过为默认 android 包生成 javadoc

Dokka - skip generating javadoc for default android packages

android

gradle

kotlin

javadoc

kotlin-dokka