Merge pull request #2887 from wmathurin/feature/migrate-doc-generation-to-dokka

Migrate doc generation to Dokka v2

Author: wmathurin

build.gradle.kts

@@ -15,6 +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:2.0.0")
     }
 }
 
@@ -32,3 +33,25 @@ allprojects {
         }
     }
 }
+
+apply(plugin = "org.jetbrains.dokka")
+
+extensions.configure<org.jetbrains.dokka.gradle.DokkaExtension> {
+    dokkaPublications.named("html") {
+        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
-    javadoc -d doc -author -version -verbose -use -doctitle "SalesforceSDK 14.0 API" -sourcepath "libs/SalesforceAnalytics/src:libs/SalesforceSDK/src:libs/SmartStore/src:libs/MobileSync/src:libs/SalesforceHybrid/src:libs/SalesforceReact/src" -subpackages com
+    ./gradlew dokkaGeneratePublicationHtml
 fi