Skip to content

ADFA-2602: Correct version references in plugin docs and metadata comments #1648

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Daniel-ADFA wants to merge 2 commits into from
Open

ADFA-2602: Correct version references in plugin docs and metadata comments #1648

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9ce76cb
ADFA-2602: Correct version references in plugin docs and metadata com…
alome007 Aug 10, 2026
fc4a392
ADFA-2602: Point plugin docs at org.adfa.constants for on-device vers…
alome007 Aug 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion common/build.gradle.kts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ android {
kotlin {
compilerOptions {
// This module's classes ship in the plugin-api coordinate that on-device plugins
// compile against, so emit metadata the on-device Kotlin (1.9.22) can read (<= 2.0.0).
// compile against, so emit metadata every supported on-device Kotlin can read (<= 2.0.0).
apiVersion.set(org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_2_0)
languageVersion.set(org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_2_0)
}
Expand Down
32 changes: 21 additions & 11 deletions docs/PLUGIN_AUTHORING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ in `build.gradle.kts`:
```kotlin
plugins {
id("com.android.application") version "8.8.2"
id("org.jetbrains.kotlin.android") version "2.1.21"
id("org.jetbrains.kotlin.android") version "2.3.0"
id("com.itsaky.androidide.plugins.build")
}

Expand All @@ -66,21 +66,31 @@ against — the `:plugin-api` module plus `common`, `eventbus-events`, and
`idetooltips`. The builder plugin applied above resolves the same way, from the
injected `com.itsaky.androidide.plugins.build` `1.0.0` marker.

#### Building on-device (offline) pins the AGP/Kotlin versions
#### Building on-device (offline) pins the AGP/Kotlin/Gradle versions

The `plugins {}` example above uses AGP `8.8.2` / Kotlin `2.1.21` — the versions the
dev/CI repo resolves online. A plugin built **on-device** resolves AGP and the Kotlin
Gradle plugin from the harvested on-device `localMvnRepository`, which currently ships
only **AGP `8.11.0`** and **Kotlin `1.9.22`**. Request those versions for an on-device
build, or offline resolution of the build plugins fails.
The `plugins {}` example above uses AGP `8.8.2` / Kotlin `2.3.0` — the versions the
dev/CI repo resolves online. A plugin built **on-device** resolves its build plugins from
the harvested on-device `localMvnRepository`, which ships only the versions pinned in
`org.adfa.constants` — `ANDROID_GRADLE_PLUGIN_VERSION`, `KOTLIN_VERSION` and
`GRADLE_DISTRIBUTION_VERSION`, currently **AGP `9.3.1`**, **Kotlin `2.3.21`** and
**Gradle `9.6.1`**. Request those, or offline resolution of the build plugins fails. That
constants file is authoritative; the numbers here are a snapshot of it.

Also declare AGP `apply false` in the **root** `build.gradle.kts` (as the standard CoGo
project template does):
AGP 9 compiles Kotlin itself and **refuses** the `org.jetbrains.kotlin.android` plugin, so
an on-device build drops it and pins Kotlin through the `kotlin-gradle-plugin` jar on the
**root** buildscript classpath, which is where AGP 9 takes its compiler from. Declare AGP
`apply false` in the same root file (as the standard CoGo project template does):

```kotlin
buildscript {
dependencies {
classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:2.3.21")
}
}

plugins {
id("com.android.application") apply false version "8.11.0"
id("com.android.library") apply false version "8.11.0"
id("com.android.application") apply false version "9.3.1"
id("com.android.library") apply false version "9.3.1"
}
```

Expand Down
2 changes: 1 addition & 1 deletion eventbus-events/build.gradle.kts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ android {
kotlin {
compilerOptions {
// This module's classes ship in the plugin-api coordinate that on-device plugins
// compile against, so emit metadata the on-device Kotlin (1.9.22) can read (<= 2.0.0).
// compile against, so emit metadata every supported on-device Kotlin can read (<= 2.0.0).
apiVersion.set(org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_2_0)
languageVersion.set(org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_2_0)
}
Expand Down
2 changes: 1 addition & 1 deletion idetooltips/build.gradle.kts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ android {
kotlin {
compilerOptions {
// This module's classes ship in the plugin-api coordinate that on-device plugins
// compile against, so emit metadata the on-device Kotlin (1.9.22) can read (<= 2.0.0).
// compile against, so emit metadata every supported on-device Kotlin can read (<= 2.0.0).
apiVersion.set(org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_2_0)
languageVersion.set(org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_2_0)
}
Expand Down
3 changes: 2 additions & 1 deletion plugin-api/build.gradle.kts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,8 @@ android {
kotlin {
compilerOptions {
jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_17)
// Emit metadata the on-device Kotlin compiler (1.9.22) can read (<= 2.0.0).
// Emit metadata every supported on-device Kotlin compiler can read (<= 2.0.0), so a
// device still on an older bundled toolchain keeps working after a KOTLIN_VERSION bump.
// This jar ships in the plugin-api coordinate on-device plugins compile against.
apiVersion.set(org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_2_0)
languageVersion.set(org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_2_0)
Expand Down
Loading