Dokka: Solve problem with <Error class: unknown class>.

Author: ASmirnov-HORIS

build.gradle.kts

@@ -36,11 +36,8 @@ if (project.file("local.properties").exists()) {
 
 allprojects {
     group = "org.jetbrains.lets-plot"
-    version = when (name) {
-        "dokka" -> "4.11.0"
-        else -> "4.11.1-SNAPSHOT"
-//        else -> "0.0.0-SNAPSHOT"  // for local publishing only
-    }
+    version = "4.11.1-SNAPSHOT"
+//    version = "0.0.0-SNAPSHOT"  // for local publishing only
 
     tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompile>().all {
         kotlinOptions {

devdocs/RELEASE.md

@@ -82,7 +82,7 @@ This is optional: needed only if a newer version of 'kotlin-jupyter-kernel' is r
       
 ##### Set Release Version
 
-- In [build.gradle.kts](../build.gradle.kts) update:`"dokka" -> <version>`
+- In [build.gradle.kts](../docs/dokka/build.gradle.kts) update `libVersion` for the Dokka.
 
 - In [v.list](../Writerside/v.list) update `version` for the Writerside.
   Check the values of `current_year` and `web_root`.

docs/dokka/build.gradle.kts

@@ -3,59 +3,58 @@
  * Use of this source code is governed by the MIT license that can be found in the LICENSE file.
  */
 
+import org.jetbrains.dokka.gradle.DokkaTask
 import java.time.LocalDateTime
 
 plugins {
     id("org.jetbrains.dokka")
 }
 
-val rootDir = rootProject.projectDir.toString().replace("\\", "/")
-val docsDir = "$rootDir/docs"
-val buildDir = "$docsDir/build"
-val dokkaDir = projectDir.toString().replace("\\", "/")
-val dokkaSrcDir = "$dokkaDir/source"
+val libVersion = "4.11.0"
+
+val rootDirectory = rootProject.projectDir.toString().replace("\\", "/")
+val docsDirectory = "$rootDirectory/docs"
+val dokkaDirectory = projectDir.toString().replace("\\", "/")
+val dokkaSrcDirectory = "$dokkaDirectory/source"
 
 val gitHubLink = "https://github.com/JetBrains/lets-plot-kotlin"
 val customFooterMessage = "Copyright © 2019-${LocalDateTime.now().year} JetBrains s.r.o."
-val customStyleSheet = "$dokkaSrcDir/custom.css"
-val customScript = "$dokkaSrcDir/custom.js"
-val logoLightImage = "$docsDir/images/logo-icon.svg"
-val logoDarkImage = "$docsDir/images/logo-dark.svg"
-val gitHubImage = "$docsDir/images/homepage.svg"
-
-tasks.dokkaHtml {
-    moduleName.set("Lets-Plot-Kotlin")
-    outputDirectory.set(File("$buildDir/api-reference"))
-    pluginsMapConfiguration.set(
-        mapOf(
-            "org.jetbrains.dokka.base.DokkaBase" to """{
-                |"customAssets": ["$customScript", "$logoLightImage", "$logoDarkImage", "$gitHubImage"],
-                |"customStyleSheets": ["$customStyleSheet"],
-                |"homepageLink": "$gitHubLink",
-                |"footerMessage": "$customFooterMessage"
-                |}""".trimMargin()
+val customStyleSheet = "$dokkaSrcDirectory/custom.css"
+val customScript = "$dokkaSrcDirectory/custom.js"
+val logoLightImage = "$docsDirectory/images/logo-icon.svg"
+val logoDarkImage = "$docsDirectory/images/logo-dark.svg"
+val gitHubImage = "$docsDirectory/images/homepage.svg"
+
+evaluationDependsOn(":plot-api")
+
+rootProject.project(":plot-api")
+    .tasks.named<DokkaTask>("dokkaHtml")
+    .configure {
+        moduleName.set("Lets-Plot-Kotlin")
+        outputDirectory.set(File("$docsDirectory/build/api-reference"))
+        pluginsMapConfiguration.set(
+            mapOf(
+                "org.jetbrains.dokka.base.DokkaBase" to """
+                {
+                  "homepageLink": "$gitHubLink",
+                  "footerMessage": "$customFooterMessage",
+                  "customAssets": [
+                    "$customScript",
+                    "$logoLightImage",
+                    "$logoDarkImage",
+                    "$gitHubImage"
+                  ],
+                  "customStyleSheets": [
+                    "$customStyleSheet"
+                  ]
+                }
+                """.trimIndent()
+            )
         )
-    )
-    dokkaSourceSets {
-        configureEach {
-            skipDeprecated.set(true)
-            includes.from("$dokkaSrcDir/packages.md")
-            perPackageOption {
-                matchingRegex.set(""".*\.frontend.*""")
-                suppress.set(true)
-            }
-            perPackageOption {
-                matchingRegex.set(""".*\.intern.*""")
-                suppress.set(true)
-            }
-            perPackageOption {
-                matchingRegex.set(""".*\.intern\.layer.*""")
-                suppress.set(false)
-            }
-        }
-        register("plotAPI") {
-            displayName.set("Plot API")
-            sourceRoots.from("$rootDir/plot-api/src/commonMain", "$rootDir/plot-api/src/jvmMain")
-        }
+    }
+
+gradle.taskGraph.whenReady {
+    if (hasTask(":plot-api:dokkaHtml")) {
+        rootProject.project(":plot-api").version = libVersion
     }
 }

plot-api/build.gradle.kts

@@ -5,6 +5,7 @@
 
 plugins {
     kotlin("multiplatform")
+    id("org.jetbrains.dokka")
     `maven-publish`
     signing
 }
@@ -73,6 +74,28 @@ kotlin {
     }
 }
 
+tasks.withType<org.jetbrains.dokka.gradle.DokkaTask>().configureEach {
+    dokkaSourceSets.configureEach {
+        skipDeprecated.set(true)
+        includes.from("${rootProject.projectDir}/docs/dokka/source/packages.md")
+
+        perPackageOption {
+            matchingRegex.set(""".*\.frontend.*""")
+            suppress.set(true)
+        }
+        perPackageOption {
+            matchingRegex.set(""".*\.intern.*""")
+            suppress.set(true)
+        }
+        perPackageOption {
+            matchingRegex.set(""".*\.intern\.layer.*""")
+            suppress.set(false)
+        }
+    }
+
+    dokkaSourceSets.named("commonMain") { displayName.set("Plot API") }
+}
+
 
 val artifactBaseName = "lets-plot-kotlin"
 val artifactGroupId = project.group as String