Migrate doc generation from Dokka v1 to v2 with HTML output

- Bump dokka-gradle-plugin from 1.9.20 to 2.0.0
- Opt in to Dokka v2 mode via gradle.properties
- Replace subprojects{} apply + dokkaHtmlMultiModule task (v1 API)
  with DokkaExtension DSL + dokka() dependencies (v2 API)
- Apply org.jetbrains.dokka to each lib subproject directly so Dokka
  can resolve their source sets for aggregation
- Switch output format from Javadoc to unified Dokka HTML so that
  doc/index.html is a proper multi-module site (Javadoc format does
  not support true multi-module aggregation in v2)
- Update generate_doc.sh: dokkaHtmlMultiModule -> dokkaGeneratePublicationHtml

Author: wmathurin

build.gradle.kts

@@ -15,7 +15,7 @@ buildscript {
         classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:2.3.20")
         classpath("org.jetbrains.kotlin:compose-compiler-gradle-plugin:2.3.21")
         classpath("org.jacoco:org.jacoco.core:0.8.14")
-        classpath("org.jetbrains.dokka:dokka-gradle-plugin:1.9.20")
+        classpath("org.jetbrains.dokka:dokka-gradle-plugin:2.0.0")
     }
 }
 
@@ -36,13 +36,22 @@ allprojects {
 
 apply(plugin = "org.jetbrains.dokka")
 
-subprojects {
-    if (path.startsWith(":libs:")) {
-        apply(plugin = "org.jetbrains.dokka")
+extensions.configure<org.jetbrains.dokka.gradle.DokkaExtension> {
+    dokkaPublications.named("html") {
+        outputDirectory.set(rootDir.resolve("doc"))
     }
 }
 
-tasks.named<org.jetbrains.dokka.gradle.DokkaMultiModuleTask>("dokkaHtmlMultiModule") {
-    moduleName.set("SalesforceSDK 14.0 API")
-    outputDirectory.set(rootDir.resolve("doc"))
+dependencies {
+    add("dokka", project(":libs:SalesforceAnalytics"))
+    add("dokka", project(":libs:SalesforceSDK"))
+    add("dokka", project(":libs:SmartStore"))
+    add("dokka", project(":libs:MobileSync"))
+    add("dokka", project(":libs:SalesforceHybrid"))
+    add("dokka", project(":libs:SalesforceReact"))
+}
+
+tasks.register<Jar>("javadocJar") {
+    from(tasks.named("dokkaGeneratePublicationHtml"))
+    archiveClassifier.set("javadoc")
 }

gradle.properties

@@ -16,3 +16,4 @@ android.r8.optimizedResourceShrinking=false
 android.builtInKotlin=false
 # TODO: This should be resolved in a dedicated work item. ECJ20260423
 android.newDsl=false
+org.jetbrains.dokka.experimental.gradle.pluginMode=V2EnabledWithHelpers

libs/MobileSync/build.gradle.kts

@@ -7,6 +7,7 @@ plugins {
     `kotlin-android`
     `publish-module`
     jacoco
+    id("org.jetbrains.dokka")
 }
 
 dependencies {

libs/SalesforceAnalytics/build.gradle.kts

@@ -7,6 +7,7 @@ plugins {
     `kotlin-android`
     `publish-module`
     jacoco
+    id("org.jetbrains.dokka")
 }
 
 dependencies {

libs/SalesforceHybrid/build.gradle.kts

@@ -9,6 +9,7 @@ plugins {
     `kotlin-android`
     `publish-module`
     jacoco
+    id("org.jetbrains.dokka")
 }
 
 dependencies {

libs/SalesforceReact/build.gradle.kts

@@ -18,6 +18,7 @@ plugins {
     `kotlin-android`
     `publish-module`
     jacoco
+    id("org.jetbrains.dokka")
 }
 
 dependencies {

libs/SalesforceSDK/build.gradle.kts

@@ -10,6 +10,7 @@ plugins {
     kotlin("plugin.serialization") version "2.3.20"
     kotlin("plugin.parcelize")
     kotlin("plugin.compose")
+    id("org.jetbrains.dokka")
 }
 
 dependencies {

libs/SmartStore/build.gradle.kts

@@ -7,6 +7,7 @@ plugins {
     `kotlin-android`
     `publish-module`
     jacoco
+    id("org.jetbrains.dokka")
 }
 
 dependencies {

tools/generate_doc.sh

@@ -3,5 +3,5 @@ if [ ! -d "external" ]
 then
     echo "You must run this tool from the root directory of your repo clone"
 else
-    ./gradlew dokkaHtmlMultiModule
+    ./gradlew dokkaGeneratePublicationHtml
 fi