Backport kxDT-as-KUP infrastructure and migration changes (#560)

* Update Gradle to 8.5
- JDK 21 support is required for builds as a Kotlin user project

* Rework infrastructure for builds as a Kotlin user project

* Perform a minor Kotlin-related cleanup
- the deprecated `kotlin.js.compiler` Gradle property is removed from `gradle.properties`
- the deprecated `kotlin.native.ignoreIncorrectDependencies` Gradle property is removed from `gradle.properties`
- `:kotlinx-datetime:compileCommonJsMainKotlinMetadata` task is enabled back to preserve compilation correctness (see KT-66382 for more details)

* [migration to Kotlin 1.9.24] Update build scripts w.r.t. KT-65864

* [migration to Kotlin 2.2.0] Update build scripts w.r.t. KT-54110

* [migration to Kotlin 2.2.0] Update Kotlin code w.r.t. KT-74897

* [migration to Kotlin APIV 2.2] Update Kotlin code w.r.t. KT-76394

* [migration to Kotlin 2.2.20] Update Kotlin code w.r.t. KT-77986

---------

Co-authored-by: Nikolay Lunyak <nikolay.lunyak@jetbrains.com>

Author: FenstonSingel

benchmarks/build.gradle.kts

@@ -3,6 +3,8 @@
  * Use of this source code is governed by the Apache 2.0 License that can be found in the LICENSE.txt file.
  */
 
+import org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask
+
 plugins {
     id("kotlin")
     id("me.champeau.jmh")
@@ -32,3 +34,10 @@ tasks.named<Jar>("jmhJar") {
 repositories {
     mavenCentral()
 }
+
+// !! infrastructure for builds as a Kotlin user project
+tasks.named("assemble") {
+    // compile all Kotlin code from the module during full-repository builds
+    // so that it's covered during builds as a Kotlin user project
+    dependsOn(tasks.withType<KotlinCompilationTask<*>>())
+}

build.gradle.kts

@@ -1,3 +1,6 @@
+import org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask
+import org.jetbrains.kotlin.gradle.tasks.KotlinJvmCompile
+
 plugins {
     id("kotlinx.team.infra") version "0.4.0-dev-85"
     kotlin("multiplatform") apply false
@@ -22,28 +25,25 @@ val modularJavaToolchainVersion by ext(project.property("java.modularToolchainVe
 
 allprojects {
     repositories {
-        addTrainRepositories(project)
         mavenCentral()
-    }
-    tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompile>().configureEach {
-        // outputs the compiler version to logs so we can check whether the train configuration applied
-        kotlinOptions.freeCompilerArgs += "-version"
-    }
-    tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinJvmCompile>().configureEach {
-        compilerOptions { freeCompilerArgs.add("-Xjvm-default=all-compatibility") }
-    }
-    tasks.withType<org.jetbrains.kotlin.gradle.tasks.Kotlin2JsCompile>().configureEach {
-        compilerOptions { freeCompilerArgs.add("-Xpartial-linkage-loglevel=ERROR") }
-    }
-    tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinNativeCompile>().configureEach {
-        compilerOptions { freeCompilerArgs.add("-Xpartial-linkage-loglevel=ERROR") }
+        kupInfra {
+            kupArtifactsRepo(context = project)
+        }
     }
 }
 
-// Disable NPM to NodeJS nightly compatibility check.
-// Drop this when NodeJs version that supports latest Wasm become stable
-tasks.withType<org.jetbrains.kotlin.gradle.targets.js.npm.tasks.KotlinNpmInstallTask>().configureEach {
-    args.add("--ignore-engines")
+subprojects {
+    // drop this after migration to 2.2.0
+    tasks.withType<KotlinJvmCompile>().configureEach {
+        compilerOptions {
+            freeCompilerArgs.add("-Xjvm-default=all-compatibility")
+        }
+    }
+    kupInfra {
+        tasks.withType<KotlinCompilationTask<*>>().configureEach {
+            kupConfiguration()
+        }
+    }
 }
 
 kover {

buildSrc/build.gradle.kts

@@ -8,31 +8,40 @@ plugins {
     `kotlin-dsl`
 }
 
-val props = Properties().apply {
-    file("../gradle.properties").inputStream().use { load(it) }
-}
+repositories {
+    mavenCentral()
+    gradlePluginPortal()
 
-// copy-pasted from `CommunityProjectsBuild`, see the explanation there
-fun RepositoryHandler.addTrainRepositories(project: Project) {
-    if (project.rootProject.properties["build_snapshot_train"]?.toString()?.toBoolean() == true) {
-        mavenLocal()
+    // !! infrastructure for builds as a Kotlin user project
+    // this is an inlined version of `KotlinUserProjectUtilities.kupArtifactsRepo`
+    // (because `buildSrc/.../KotlinUserProjectInfra.kt` is not available here)
+    val kupArtifactsRepoURL = providers.gradleProperty("kotlin_repo_url").orNull
+    if (kupArtifactsRepoURL != null) {
+        maven(kupArtifactsRepoURL)
+        logger.lifecycle("[KUP infra] Added '$kupArtifactsRepoURL' as a Maven repo to ':buildSrc'")
     }
-    (project.rootProject.properties["kotlin_repo_url"] as? String)?.let(::maven)
 }
 
-// copy-pasted from `CommunityProjectsBuild`, but uses `props` to obtain the non-snapshot version, because
-// we don't have access to the properties defined in `gradle.properties` of the encompassing project
-val Project.kotlinVersion: String
-    get() = if (rootProject.properties["build_snapshot_train"]?.toString()?.toBoolean() == true) {
-        rootProject.properties["kotlin_snapshot_version"] as? String ?: error("kotlin_snapshot_version must be specified")
-    } else {
-        props.getProperty("defaultKotlinVersion")
-    }
-
-repositories {
-    mavenCentral()
-    gradlePluginPortal()
-    addTrainRepositories(project)
+// !! infrastructure for builds as a Kotlin user project
+/**
+ * the value provided via the `kotlin_version` Gradle property if any
+ * (otherwise, `defaultKotlinVersion` defined in `gradle.properties` of the root project is used instead);
+ * note that there is no direct `buildSrc/.../KotlinUserProjectInfra.kt` analogue for this utility
+ * because `kotlin_version` is commonly used where `buildSrc/.../KotlinUserProjectInfra.kt` is not available
+ * (`settings.gradle.kts`, `buildSrc`, etc.)
+ */
+val Project.kotlinVersion: String by lazy {
+    val kotlinVersion: String = providers.gradleProperty("kotlin_version").orNull
+        ?: run {
+            // we don't have access to the properties defined in `gradle.properties` of the root project,
+            // so we have to get them manually
+            val properties = Properties().apply {
+                file("../gradle.properties").inputStream().use { load(it) }
+            }
+            properties.getProperty("defaultKotlinVersion")
+        }
+    logger.lifecycle("[KUP infra] Set Kotlin distribution version to '$kotlinVersion'")
+    kotlinVersion
 }
 
 dependencies {