Skip to content

Commit 643ce1b

Browse files
committed
chore: add generated sources change to 2.3.0 compat guide
1 parent 13f49ca commit 643ce1b

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

docs/topics/compatibility-guides/compatibility-guide-23.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -735,6 +735,22 @@ perspective (for example, from Java) is out of the scope of this document.
735735
> - 2.2.20: report a warning
736736
> - 2.3.0: raise the warning to an error
737737
738+
### Change the approach to registering all generated sources
739+
740+
> **Issue**: [KT-45161](https://youtrack.jetbrains.com/issue/KT-45161)
741+
>
742+
> **Component**: Gradle
743+
>
744+
> **Incompatible change type**: source
745+
>
746+
> **Short summary**: Kotlin 2.3.0 introduces a new [Experimental](components-stability.md#stability-levels-explained) API in the [`KotlinSourceSet`](https://kotlinlang.org/api/kotlin-gradle-plugin/kotlin-gradle-plugin-api/org.jetbrains.kotlin.gradle.plugin/-kotlin-source-set/) interface that lets you [register generated
747+
> sources](gradle-configure-project.md#register-generated-sources) in a Gradle project. Previously, you could use the [`kotlin`](https://kotlinlang.org/api/kotlin-gradle-plugin/kotlin-gradle-plugin-api/org.jetbrains.kotlin.gradle.plugin/-kotlin-source-set/kotlin.html) property
748+
> to access all the generated sources. Starting with Kotlin 2.3.0, you must migrate to using the [`allKotlinSources`](https://kotlinlang.org/api/kotlin-gradle-plugin/kotlin-gradle-plugin-api/org.jetbrains.kotlin.gradle.plugin/-kotlin-source-set/all-kotlin-sources.html) property instead.
749+
>
750+
> **Migration advice**:
751+
> * To register generated sources, use the [`generatedKotlin`](https://kotlinlang.org/api/kotlin-gradle-plugin/kotlin-gradle-plugin-api/org.jetbrains.kotlin.gradle.plugin/-kotlin-source-set/generated-kotlin.html) property.
752+
> * To access all sources, including non-generated sources, use the [`allKotlinSources`](https://kotlinlang.org/api/kotlin-gradle-plugin/kotlin-gradle-plugin-api/org.jetbrains.kotlin.gradle.plugin/-kotlin-source-set/all-kotlin-sources.html) property.
753+
738754
## Build tool removal
739755

740756
### Remove support for Ant

0 commit comments

Comments
 (0)