使用Gradle打包Kotlin项目代码、生成Kotlin代码文档

Kotlin项目

在 Root Project 下的 build.gradle 文件中 buildscript 下的 dependencies 中添加：

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

在 module 下的 build.gradle 文件中添加：

apply plugin: 'org.jetbrains.dokka'task generateSourcesJar(type: Jar) {    group = 'jar'    from sourceSets.main.java.srcDirs    classifier = 'sources'}task dokkaJavadoc(type: org.jetbrains.dokka.gradle.DokkaTask) {    outputFormat = "javadoc"    outputDirectory = javadoc.destinationDir}task generateJavadoc(type: Jar, dependsOn: dokkaJavadoc) {    group = 'jar'    classifier = 'javadoc'    from javadoc.destinationDir}artifacts {    archives generateJavadoc    archives generateSourcesJar}

其中， generateSourcesJar Task 中的 from sourceSets.main.java.srcDirs 需要根据项目实际源码目录填写。

同步之后，在 gradle 的任务列表中的 jar 分组下就可以看到 generateSourcesJar 和 generateJavadoc 两个任务了。
双击这两个任务，sources.jar 和 javadoc.jar 就会生成，位置在 build/libs 目录下。

使用Kotlin开发的Android项目

在 Root Project 下的 build.gradle 文件中 buildscript 下的 dependencies 中添加：

classpath 'org.jetbrains.dokka:dokka-android-gradle-plugin:0.9.15'

在 module 下的 build.gradle 文件中添加：

apply plugin: 'org.jetbrains.dokka-android'task generateSourcesJar(type: Jar) {    group = 'jar'    from android.sourceSets.main.java.srcDirs    classifier = 'sources'}task javadoc(type: Javadoc) {    source = android.sourceSets.main.java.srcDirs    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))}task dokkaJavadoc(type: org.jetbrains.dokka.gradle.DokkaTask) {    outputFormat = "javadoc"    outputDirectory = javadoc.destinationDir}task generateJavadoc(type: Jar, dependsOn: dokkaJavadoc) {    group = 'jar'    classifier = 'javadoc'    from javadoc.destinationDir}artifacts {    archives generateJavadoc    archives generateSourcesJar}

其中， generateSourcesJar Task 和 javadoc Task 中的 sourceSets.main.java.srcDirs 需要根据项目实际源码目录填写。

同步之后，在 gradle 的任务列表中的 jar 分组下就可以看到 generateSourcesJar 和 generateJavadoc 两个任务了。
双击这两个任务，sources.jar 和 javadoc.jar 就会生成，位置在 build/libs 目录下。

相关参考链接

Documenting Kotlin Code

Github Kotlin/dokka