Include Dokka for language-agnostic doc generation (#176)

Author: mannodermaus

build.gradle.kts

@@ -13,6 +13,8 @@ buildscript {
     classpath(Libs.gradle_bintray_plugin)
     classpath(Libs.android_maven_gradle_plugin)
     classpath(Libs.gradle_versions_plugin)
+    classpath(Libs.dokka_core_plugin)
+    classpath(Libs.dokka_android_plugin)
   }
 }
 

buildSrc/src/main/kotlin/Libs.kt

@@ -64,6 +64,18 @@ object Libs {
             "com.github.dcendents:android-maven-gradle-plugin:" +
             Versions.android_maven_gradle_plugin
 
+    /**
+     * https://github.com/Kotlin/dokka */
+    const val dokka_core_plugin: String =
+        "org.jetbrains.dokka:dokka-gradle-plugin:" +
+            Versions.dokka
+
+    /**
+     * https://github.com/Kotlin/dokka */
+    const val dokka_android_plugin: String =
+        "org.jetbrains.dokka:dokka-android-gradle-plugin:" +
+            Versions.dokka
+
     /**
      * https://github.com/zafarkhaja/jsemver */
     const val java_semver: String = "com.github.zafarkhaja:java-semver:" + Versions.java_semver

buildSrc/src/main/kotlin/Versions.kt

@@ -28,7 +28,9 @@ object Versions {
 
     const val gradle_versions_plugin: String = "0.20.0" 
 
-    const val android_maven_gradle_plugin: String = "2.1" 
+    const val android_maven_gradle_plugin: String = "2.1"
+
+    const val dokka: String = "0.9.18"
 
     const val java_semver: String = "0.9.0" 
 

gradle/deployment.gradle

@@ -53,18 +53,15 @@ if (targetPlatform == "java") {
 
 // Include javadoc.jar archive in each release
 if (targetPlatform == "android") {
-  task javadoc(type: Javadoc) {
-    source = android.sourceSets.main.java.srcDirs
-    excludes = ["**/*.kt"]
-    failOnError = false
-    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
-  }
+  apply plugin: "org.jetbrains.dokka-android"
+} else {
+  apply plugin: "org.jetbrains.dokka"
 }
 
-task javadocJar(type: Jar, dependsOn: javadoc) {
+task javadocJar(type: Jar, dependsOn: dokka) {
   baseName = artifactId
   classifier = "javadoc"
-  from javadoc.destinationDir
+  from dokka.outputDirectory
 }
 
 // ------------------------------------------------------------------------------------------------