一、gradle 发布版本
参考:gradle 发布版本
Java版本兼容:
Java version | First Gradle version to support it |
---|---|
8 | 2.0 |
9 | 4.3 |
10 | 4.7 |
11 | 5.0 |
12 | 5.4 |
13 | 6.0 |
14 | 6.3 |
15 | 6.7 |
16 | 7.0 |
17 | 7.3 |
二、gradle 版本和 gradle 插件版本 匹配兼容
参考:gradle 版本和 gradle 插件版本 匹配兼容
下表列出了各个 Android Gradle 插件版本所需的 Gradle 版本。为了获得最佳性能,您应使用 Gradle 和插件这两者的最新版本。
插件版本 | 所需的 Gradle 版本 |
---|---|
1.0.0 - 1.1.3 | 2.2.1 - 2.3 |
1.2.0 - 1.3.1 | 2.2.1 - 2.9 |
1.5.0 | 2.2.1 - 2.13 |
2.0.0 - 2.1.2 | 2.10 - 2.13 |
2.1.3 - 2.2.3 | 2.14.1 - 3.5 |
2.3.0+ | 3.3+ |
3.0.0+ | 4.1+ |
3.1.0+ | 4.4+ |
3.2.0 - 3.2.1 | 4.6+ |
3.3.0 - 3.3.3 | 4.10.1+ |
3.4.0 - 3.4.3 | 5.1.1+ |
3.5.0 - 3.5.4 | 5.4.1+ |
3.6.0 - 3.6.4 | 5.6.4+ |
4.0.0+ | 6.1.1+ |
4.1.0+ | 6.5+ |
4.2.0+ | 6.7.1+ |
7.0 | 7.0+ |
Android Gradle 插件和 Android Studio 兼容性
Android Studio 版本 | 所需的 Android Gradle 插件(AGP) 版本 |
---|---|
考拉 (2024 年 1 月 1 日) | 3.2-8.5 |
水母 (2023 年 3 月 1 日) | 3.2-8.4 |
Iguana (2023.2.1) | 3.2-8.3 |
Hedgehog (2023.1.1 | 3.2-8.2 |
Giraffe (2022.3.1 | 3.2-8.1 |
Flamingo (2022.2.1) | 3.2-8.0 |
Electric Eel (2022.1.1) | 3.2-7.4 |
Dolphin (2021.3.1) | 3.2-7.3 |
Chipmunk (2021.2.1) | 3.2-7.2 |
Bumblebee (2021.1.1) | 3.2-7.1 |
Arctic Fox (2020.3.1) | 3.1-7.0 |
特定 Android API 级别所要求的最低工具版本
Android Studio 和 AGP 需要满足最低版本要求才能支持特定 API 级别。
如果使用的 Android Studio 或 AGP 版本低于项目的 targetSdk 或 compileSdk 所要求的版本,可能会导致意外问题。
我们建议您使用最新的预览版 Android Studio 和 AGP 来处理以预览版 Android OS 为目标平台的项目。
您可以 安装 Android Studio 的预览版以及稳定版。
Android Studio 和 AGP 的最低版本如下所示:
API 级别 | 最低 Android Studio 版本 | 最低 AGP 版本 |
---|---|---|
VanillaIceCream 预览版 | 水母 2023 年 3 月 1 日 | 8.4 |
34 | Hedgehog (2023.1.1) | 8.1.1 |
33 | Flamingo (2022.2.1) | 7.2 |
可以在 Android Studio 的 File > Project Structure > Project
菜单中指定插件版本,也可以在顶级 build.gradle 文件中进行指定。
三、kotlin
Kotlin Gradle Plugin : maven 仓库
maven仓库 : Kotlin Stdlib : Kotlin Standard Library for JVM
问题:Kotlin version that is used for building with Gradle (+) differs from the one bundled into the IDE plugin 1.5.20
Kotlin version that is used for building with Gradle (+)
differs from the one bundled into the IDE plugin 1.5.20
查看Android studio 自带kotlin插件版本(保证stable版本):
查看项目中 kotlin 插件版本,改为stable版本即可:
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.5.20"
问题 : Module was compiled with an incompatible version of Kotlin.The binary version of its metadata is 1.6.0, expected version is 1.4.0.
e: Incompatible classes were found in dependencies.
Remove them from the classpath or use '-Xskip-metadata-version-check' to suppress errors
e: /Users/tmk/.gradle/caches/modules-2/files-2.1/androidx.annotation/
annotation/1.4.0-alpha01/8c16c0d1fad0d41cdac0394c7fa16a25a4210248/
annotation-1.4.0-alpha01.jar!/META-INF/annotation.kotlin_module:
Module was compiled with an incompatible version of Kotlin.
The binary version of its metadata is 1.6.0, expected version is 1.4.0.
e: /Users/tmk/.m2/repository/org/jetbrains/kotlin/
kotlin-stdlib-common/1.6.0/kotlin-stdlib-common-1.6.0.jar!/
META-INF/kotlin-stdlib-common.kotlin_module:
Module was compiled with an incompatible version of Kotlin.
The binary version of its metadata is 1.6.0, expected version is 1.4.0.
解决办法:
1、gradle-wrapper.properties
中将 gradle
版本升级一下
可参考:gradle版本发行
2、classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.6.0"
将 kotlin
版本升级一下
可参考 : kotlin-gradle-plugin
Android下载gradle失败的解决方法
1、在gradle-wrapper.properties文件中查看自己需要下载gradle什么版本的包和zip路径(wrapper/dists)
2、在setting中查看Gradle的保存路径,如下图:C:/Users/Administrator/.gradle,加上第一步的zip路径得到下载gradle zip包路径即:C:/Users/Administrator/.gradle/wrapper/dists。
3、去gradle网站下载对应的gradle版本
4、然后找到对应的位置把已经下载好的安装包放进去,不用解压缩
5、然后重新build项目即可
gradle 与 Java 兼容性 :
Java 版本 | 第一个支持它的 Gradle 版本 |
---|---|
8 | 2.0 |
9 | 4.3 |
10 | 4.7 |
11 | 5.0 |
12 | 5.4 |
13 | 6.0 |
14 | 6.3 |
15 | 6.7 |
16 | 7.0 |
17 | 7.3 |
18 | 7.5 |
19 | 7.6 |
20 | 8.1 |
File->Settings->搜索Gradle,在Gradle节点下 gradle jdk修改
gradle嵌入 Kotlin 版本
Gradle 版本 | 嵌入式 Kotlin 版本 | Kotlin 语言版本 |
---|---|---|
5.0 | 1.3.10 | 1.3 |
5.1 | 1.3.11 | 1.3 |
5.2 | 1.3.20 | 1.3 |
5.3 | 1.3.21 | 1.3 |
5.5 | 1.3.31 | 1.3 |
5.6 | 1.3.41 | 1.3 |
6.0 | 1.3.50 | 1.3 |
6.1 | 1.3.61 | 1.3 |
6.3 | 1.3.70 | 1.3 |
6.4 | 1.3.71 | 1.3 |
6.5 | 1.3.72 | 1.3 |
6.8 | 1.4.20 | 1.3 |
7.0 | 1.4.31 | 1.4 |
7.2 | 1.5.21 | 1.4 |
7.3 | 1.5.31 | 1.4 |
7.5 | 1.6.21 | 1.4 |
7.6 | 1.7.10 | 1.4 |
8.0 | 1.8.10 | 1.8 |
8.2 | 1.8.20 | 1.8 |
各 Android 平台版本所支持的 API 级别
平台版本 | API 级别 | VERSION_CODE |
---|---|---|
Android 15 | 35 | VANILLA_ICE_CREAM |
Android 14 | 34 | UPSIDE_DOWN_CAKE |
Android 13 | 33 | TIRAMISU |
Android 12 | 32 | S_V2 |
Android 12 | 31 | S |
Android 11 | 30 | R |
Android 10 | 29 | Q |
Android 9 | 28 | P |
Android 8.1 | 27 | O_MR1 |
Android 8.0 | 26 | O |
Android 7.1.1 | 25 | N_MR1 |
Android 7.1 | 25 | N_MR1 |
Android 7.0 | 24 | N |
Android 6.0 | 23 | M |
Android 5.1 | 22 | LOLLIPOP_MR1 |
Android 5.0 | 21 | LOLLIPOP |
Android 4.4W | 20 | KITKAT_WATCH 仅限 KitKat for Wearables |
Android 4.4 | 19 | KITKAT |
Android 4.3 | 18 | JELLY_BEAN_MR2 |
Android 4.2、4.2.2 | 17 | JELLY_BEAN_MR1 |
Android 4.1、4.1.1 | 16 | JELLY_BEAN |
Android 4.0.3、4.0.4 | 15 | ICE_CREAM_SANDWICH_MR1 |
Android 4.0、4.0.1、4.0.2 | 14 | ICE_CREAM_SANDWICH |
Android 3.2 | 13 | HONEYCOMB_MR2 |
Android 3.1.x | 12 | HONEYCOMB_MR1 |
Android 3.0.x | 11 | HONEYCOMB |
Android 2.3.4 | 10 | GINGERBREAD_MR1 |
Android 2.3.3 | 10 | GINGERBREAD_MR1 |
Android 2.3.2 | 9 | GINGERBREAD |
Android 2.3.1 | 9 | GINGERBREAD |
Android 2.3 | 9 | GINGERBREAD |
Android 2.2.x | 8 | FROYO |
Android 2.1.x | 7 | ECLAIR_MR1 |
Android 2.0.1 | 6 | ECLAIR_0_1 |
Android 2.0 | 5 | ECLAIR |
Android 1.6 | 4 | DONUT |
Android 1.5 | 3 | CUPCAKE |
Android 1.1 | 2 | BASE_1_1 |
Android 1.0 | 1 | BASE |