Skip to content

开始使用 Dokka

以下是帮助您开始使用 Dokka 的简单说明。

在您的项目的根构建脚本中应用 Dokka 的 Gradle 插件:

kotlin
plugins {
    id("org.jetbrains.dokka") version "2.0.0"
}

当您为 多项目 构建生成文档时,您还需要在子项目中应用 Gradle 插件:

kotlin
subprojects {
    apply(plugin = "org.jetbrains.dokka")
}

要生成文档,请运行以下 Gradle 任务:

  • dokkaHtml,用于单项目构建
  • dokkaHtmlMultiModule,用于多项目构建

默认情况下,输出目录设置为 /build/dokka/html/build/dokka/htmlMultiModule

要了解更多关于 Dokka 与 Gradle 的用法,请参见 Gradle

在您的项目的根构建脚本中应用 Dokka 的 Gradle 插件:

groovy
plugins {
    id 'org.jetbrains.dokka' version '2.0.0'
}

当您为 多项目 构建生成文档时,您还需要在子项目中应用 Gradle 插件:

groovy
subprojects {
    apply plugin: 'org.jetbrains.dokka'
}

要生成文档,请运行以下 Gradle 任务:

  • dokkaHtml,用于单项目构建
  • dokkaHtmlMultiModule,用于多项目构建

默认情况下,输出目录设置为 /build/dokka/html/build/dokka/htmlMultiModule

要了解更多关于 Dokka 与 Gradle 的用法,请参见 Gradle

将 Dokka 的 Maven 插件添加至您的 POM 文件的 plugins 部分:

xml
<build>
    <plugins>
        <plugin>
            <groupId>org.jetbrains.dokka</groupId>
            <artifactId>dokka-maven-plugin</artifactId>
            <version>2.0.0</version>
            <executions>
                <execution>
                    <phase>pre-site</phase>
                    <goals>
                        <goal>dokka</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

要生成文档,请运行 dokka:dokka 目标。

默认情况下,输出目录设置为 target/dokka

要了解更多关于 Dokka 与 Maven 的用法,请参见 Maven

在 Dokka 2.0.0 中,若干入门步骤和任务已更新,包括:

有关更多详细信息和完整更改列表,请参见 迁移指南