dokka tasks improved.

Author: syslogic

gradle/wrapper/gradle-wrapper.properties

@@ -16,7 +16,7 @@
 
 #Thu Sep 12 17:12:58 EEST 2024
 distributionBase=GRADLE_USER_HOME
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.1.0-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.1-bin.zip
 distributionPath=wrapper/dists
 zipStorePath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME

wallet-core/build.gradle.kts

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 
+import com.android.build.gradle.internal.tasks.factory.dependsOn
 import com.github.jk1.license.filter.DependencyFilter
 import com.github.jk1.license.filter.ExcludeTransitiveDependenciesFilter
 import com.github.jk1.license.filter.LicenseBundleNormalizer
@@ -180,34 +181,53 @@ dependencyCheck {
 // Dokka generation
 dokka {
     dokkaSourceSets.configureEach {
+        dokkaPublications.javadoc {
+            outputDirectory.set(rootProject.file("docs/javadoc"))
+        }
         dokkaPublications.html {
-            outputDirectory.set(rootProject.file("docs"))
+            outputDirectory.set(rootProject.file("docs/html"))
         }
         externalDocumentationLinks.register("android") {
             url("https://developer.android.com/reference")
             packageListUrl("https://developer.android.com/reference/kotlin/package-list")
         }
-        externalDocumentationLinks.register("java") {
-            url("https://docs.oracle.com/en/java/javase/17/docs/api/")
-            packageListUrl("https://docs.oracle.com/en/java/javase/17/docs/api/allpackages-index.html")
-        }
     }
 }
 
-val dokkaHtmlJar by tasks.registering(Jar::class) {
-    group = "documentation"
+val dokkaGenerateJavadocJar by tasks.registering(Jar::class) {
+    group = "dokka"
+    dependsOn(tasks.dokkaGeneratePublicationJavadoc)
+    from(tasks.dokkaGeneratePublicationJavadoc.flatMap { it.outputDirectory })
+    archiveClassifier.set("javadoc")
+    description = "Assembles a JAR containing the Javadoc-style documentation generated by Dokka."
+}
+
+val dokkaGenerateHtmlJar by tasks.registering(Jar::class) {
+    group = "dokka"
     dependsOn(tasks.dokkaGeneratePublicationHtml)
     from(tasks.dokkaGeneratePublicationHtml.flatMap { it.outputDirectory })
     archiveClassifier.set("html-docs")
     description = "Assembles a JAR containing the HTML documentation generated by Dokka."
 }
 
-val dokkaJavadocJar by tasks.registering(Jar::class) {
-    group = "documentation"
-    dependsOn(tasks.dokkaGeneratePublicationJavadoc)
-    from(tasks.dokkaGeneratePublicationJavadoc.flatMap { it.outputDirectory })
-    archiveClassifier.set("javadoc")
-    description = "Assembles a JAR containing the Javadoc-style documentation generated by Dokka."
+val dokkaCleanJavadoc by tasks.registering(Delete::class) {
+    group = "dokka"
+    delete = setOf(rootProject.file("docs/javadoc"))
+    description = "It removes the documentation generated by Dokka."
+}
+
+val dokkaCleanHtml by tasks.registering(Delete::class) {
+    group = "dokka"
+    delete = setOf(rootProject.file("docs/html"))
+    description = "It removes the documentation generated by Dokka."
+}
+
+tasks.dokkaGeneratePublicationJavadoc.dependsOn(dokkaCleanJavadoc)
+tasks.dokkaGeneratePublicationHtml.dependsOn(dokkaCleanHtml)
+
+val dokkaClean by tasks.registering() {
+    group = "dokka"
+    dependsOn(dokkaCleanJavadoc, dokkaCleanHtml)
 }
 
 // Third-party licenses report
@@ -236,8 +256,8 @@ tasks.generateLicenseReport.configure {
 // Build documentation and license report
 tasks.register<Task>("buildDocumentation") {
     group = "documentation"
-    dependsOn("dokkaGfm", "generateLicenseReport")
-    description = "Aggregates all documentation tasks (Dokka GFM, License Report)."
+    dependsOn("dokkaGenerate", "generateLicenseReport")
+    description = "Aggregates all documentation tasks (Dokka, License Report)."
 }
 tasks.assemble.configure {
     finalizedBy("buildDocumentation")