Migrate buildSrc to composite build

build-logic/README.md

@@ -0,0 +1,7 @@
+# About Build-logic Module
+
+This module aims to share common build logic for whole projects, previously we were using [buildSrc](https://docs.gradle.org/7.6/userguide/organizing_gradle_projects.html#sec:build_sources),
+but for some reasons like "A change in buildSrc causes the whole project to become out-of-date", we are migrating to [composite builds](https://docs.gradle.org/7.6/userguide/composite_builds.html),
+which avoids the side effects of buildSrc.
+
+For more information, you can ref https://proandroiddev.com/stop-using-gradle-buildsrc-use-composite-builds-instead-3c38ac7a2ab3.

buildSrc/build.gradle.kts → build-logic/build.gradle.kts

@@ -6,8 +6,17 @@ repositories {
     gradlePluginPortal()
 }
 
+gradlePlugin {
+    plugins {
+        create("build-logic") {
+            id = "build-logic"
+            implementationClass = "org.jetbrains.BuildLogic"
+        }
+    }
+}
+
 dependencies {
     implementation("com.github.jengelman.gradle.plugins:shadow:2.0.4")
-    implementation("org.jetbrains.kotlinx:binary-compatibility-validator:0.10.1")
+    implementation("org.jetbrains.kotlinx:binary-compatibility-validator:0.11.1")
     implementation("io.github.gradle-nexus:publish-plugin:1.1.0")
 }

build-logic/settings.gradle.kts

@@ -0,0 +1 @@
+// empty.

build-logic/src/main/kotlin/org/jetbrains/BuildLogic.kt

@@ -0,0 +1,10 @@
+package org.jetbrains
+
+import org.gradle.api.Plugin
+import org.gradle.api.Project
+
+class BuildLogic : Plugin<Project> {
+    override fun apply(project: Project) {
+        // Do nothing.
+    }
+}

build.gradle.kts

@@ -5,12 +5,14 @@ plugins {
     kotlin("jvm") apply false
     id("java")
     id("org.jetbrains.dokka") version "1.7.20"
-    id("io.github.gradle-nexus.publish-plugin")
+    id("io.github.gradle-nexus.publish-plugin") version "1.1.0"
+    id("build-logic") apply false
 }
 
 val dokka_version: String by project
 
 allprojects {
+    apply(plugin = "build-logic")
     configureDokkaVersion()
 
     group = "org.jetbrains.dokka"

settings.gradle.kts

@@ -1,5 +1,7 @@
 rootProject.name = "dokka"
 
+includeBuild("build-logic")
+
 include("core")
 include("core:test-api")
 include("core:content-matcher-test-utils")