[K2] Run unit tests against the latest Analysis API (#3552)

Kotlin · Apr 5, 2024 · cbb8314 · cbb8314 · Chief1934 · Sep 7, 2024
1 parent 7a25a0c
commit cbb8314
Show file tree

Hide file tree

Showing 2 changed files with 23 additions and 0 deletions.
diff --git a/dokka-subprojects/analysis-kotlin-symbols/README.md b/dokka-subprojects/analysis-kotlin-symbols/README.md
@@ -16,3 +16,9 @@ The `.jar` produced by this project shadows all dependencies. There are several
 2. There are many intertwining transitive dependencies of different versions, as well as direct copy-paste,
    that can lead to runtime errors due to classpath conflicts, so it's best to let Gradle take care of
    dependency resolution, and then pack everything into a single jar in a single place that can be tuned.
+
+## Testing with an override version of Analysis API
+
+To build it with an override version of Analysis API, the property 
+`org.jetbrains.dokka.build.overrideAnalysisAPIVersion=2.2.0-dev-*` should be added to the project. Any version can be set in the property instead of `2.2.0-dev-*`.
+
diff --git a/settings.gradle.kts b/settings.gradle.kts
@@ -104,3 +104,20 @@ include(
 project(":dokka-subprojects:core").name = "dokka-core"
 
 enableFeaturePreview("TYPESAFE_PROJECT_ACCESSORS")
+
+// OVERWRITING CATALOG VERSIONS
+// for testing against the latest dev version of Analysis API
+// currently, Analysis API is used only in the analysis-kotlin-symbols project
+dependencyResolutionManagement {
+    versionCatalogs {
+        create("libs") {
+            val kotlinCompilerK2Version = providers.gradleProperty(
+                "org.jetbrains.dokka.build.overrideAnalysisAPIVersion"
+            ).orNull
+            if (kotlinCompilerK2Version != null) {
+                logger.lifecycle("Using the override version $kotlinCompilerK2Version of Analysis API")
+                version("kotlin-compiler-k2", kotlinCompilerK2Version)
+            }
+        }
+    }
+}