Skip to content

Commit 91dfe5e

Browse files
authored
docs: update API_COMPATIBILITY.md (#233)
## Summary by CodeRabbit * **Documentation** * Updated known issues documentation to clarify Kotlin and AGP 9 compatibility limitations for Android library projects. * Added upstream issue tracking references for improved visibility into known platform constraints.
1 parent 377f487 commit 91dfe5e

1 file changed

Lines changed: 3 additions & 1 deletion

File tree

API_COMPATIBILITY.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,10 @@ The intended replacement — Kotlin Gradle Plugin's built-in `abiValidation` —
1212

1313
### Upstream issues
1414

15+
- [KT-83410](https://youtrack.jetbrains.com/issue/KT-83410)**the tracker for our exact case.** AGP 9's built-in Kotlin uses `KotlinBaseApiPlugin`, which doesn't invoke `Project.registerKotlinPluginExtensions`, so `kotlin { abiValidation { } }` is unresolved in Android library projects. The extension-points API is internal to KGP, so AGP can't register it itself. Currently in **Backlog** — no fix planned yet.
16+
- [Google IssueTracker #470109449](https://issuetracker.google.com/issues/470109449) — companion AGP-side ticket
1517
- [Kotlin/binary-compatibility-validator#312](https://github.com/Kotlin/binary-compatibility-validator/issues/312) — BCV tasks not registered with AGP 9 (open, no maintainer response)
16-
- [KT-81117](https://youtrack.jetbrains.com/issue/KT-81117)KGP conflicts with AGP 9 built-in Kotlin
18+
- [KT-81117](https://youtrack.jetbrains.com/issue/KT-81117)resolved in Kotlin 2.4.0-Beta2 / 2.4.20-Beta1, but **does not apply to us**: scoped only to the `kotlin-multiplatform` plugin (we use `kotlin-android`), and the fix is primarily an improved error message pointing users to `com.android.kotlin.multiplatform.library`
1719
- BCV is in [maintenance mode](https://github.com/Kotlin/binary-compatibility-validator#readme), superseded by KGP's `abiValidation` (experimental since Kotlin 2.1.20)
1820

1921
### Workarounds considered

0 commit comments

Comments
 (0)