Android 版本、Plugins、Gradle、Kotlin 版本升級對照表

AGP 版本

Android 專案架構現今(2024年)已經來到非常複雜的情況,在升級時必須考慮所有外掛、Gralde 版本的配合才能順利升級。

註:如果不是使用 Kotlin 語言而是用 Java ,那就少了 KGP 版本的問題,只要把自己專案的 Gradle 版本跟著 AGP 升級就行了,此篇內容中遇到的問題基本上應該就不會發生。


最近為了把 Android 專案的 targetSDKVersion 升到 API Level 34 也就是 Android 14,又要在版本地獄裡撞牆了。為了下次升級時不要再次撞牆,決定好好研究一下到底要怎麼升級這一大堆相關的外掛的版本。

升級版本可以想成是在挖隧道,要從兩個方向往內挖,最後接在一起。其中一頭是 API Level 34,這是我們的主要目標,另一頭就是 Kotlin 版本。

API Level 34 對應的最低 Android Gradle Plugin (AGP) 是 8.1.1。

Android Studio (簡稱AS) 有內建綁定了一個 Kotlin Plugin,可以在 AS 的「設定 -> Plugins」中查看它能支援的最新版本是什麼,目前是 1.9.20,所以這就是我們能用的最頂的 Kotlin 版本,對應的 Kotlin Gradle Plugin(KGP) 選擇同一版本;KGP 它有對應的 Gradle 版本 8.1.1 (最高) 及 Android Gradle Plugin (AGP) 版本 8.1.0 (最高)。

綜合以上,Gradle 就只能用 8.1.1 (AGP min, KGP max)。

我整理了一個表可以參考下圖:

另外,如果有用到 KSP (Kotlin Symbol Processing),也要選擇和 Kotlin 相同版本號的版本。

參考網址:
https://developer.android.com/build/releases/gradle-plugin
https://kotlinlang.org/docs/gradle-configure-project.html#apply-the-plugin
https://github.com/google/ksp

本文網址:https://blog.tonycube.com/2024/07/android-gradle-kotlin-version.html
Tony Blog 撰寫,請勿全文複製,轉載時請註明出處及連結,謝謝 😀

我要留言

留言小提醒:
1.回覆時間通常在晚上,如果太忙可能要等幾天。
2.請先瀏覽一下其他人的留言,也許有人問過同樣的問題。
3.程式碼請先將它編碼後再貼上。(線上編碼:http://bit.ly/1DL6yog)
4.文字請加上標點符號及斷行,難以閱讀者恕難回覆。
5.感謝您的留言,您的問題也可能幫助到其他有相同問題的人。