Android Gradle plugin(AGP)版本变化及Android Studio使用sdk build tool 31.0.0之后需要知道的那点事

众所周知,Android Studio是基于IntelliJ IDEA开发的,从Arctic Fox版本开始,Android Studio的版本命名也追随IDEA,因此Android Studio 4.3的下一个版本就变成了:

Android Studio Arctic Fox | 2020.3.1


新版本编号系统

更新了 Android Studio 的版本编号系统

我们更改了 Android Studio 的版本编号系统,使其与 IntelliJ IDEA(Android Studio 所基于的 IDE)更一致。

在以前的编号系统中,此版本应为 Android Studio 4.3 或 4.3.0.1。采用全新的编号系统后,现在版本为 Android Studio - Arctic Fox | 2020.3.1 或 2020.3.1。

Intellij 版本旧名称旧 - 编号系统新 - 年份系统新版本名称
2020.34.34.3.02020.3.1Arctic Fox | 2020.3.1

今后,Android Studio 版本号的确定方式如下:

<Year of IntelliJ Version>.<IntelliJ major version>.<Studio major version>.<Studio minor/patch version>

  • 前两组数字表示特定 Android Studio 版本所基于的 IntellIj 平台版本。对于此版本,即为 2020.3。
  • 第三组数字表示 Studio 的主要版本,从 1 开始,每个主要版本递增 1。
  • 第四组数字表示 Studio 的次要版本/补丁程序版本,从 1 开始,每个次要版本递增 1。
  • 此外,我们还将为每个主要版本提供版本名称,分别以 A 到 Z 的动物来命名。此版本名为 Arctic Fox。

更新了 Android Gradle 插件的版本编号系统

我们更新了 Android Gradle 插件 (AGP) 的版本编号系统,以使其更接近底层 Gradle 构建工具。因此,AGP 7.0 是继 AGP 4.2 之后的下一个版本。

如需了解详情,请参阅 AGP 版本说明中的版本编号变更


Android Gradle plugin的变化

We are updating the version numbering for Android Gradle plugin (AGP) to more closely match the underlying Gradle build tool.
 
AGP 7.0 is the version that follows AGP 4.2. AGP 7.0 is being released concurrently with Android Studio Arctic Fox | 2020.3.1.

也就是说,AGP的版本变化也来了个大跳跃,从4.2直接飙到7.0了。


从Android SDK Build-Tools 31开始,删除了dx.bat,由d8.bat替代,带来的影响就是,如果你使用的是

buildToolsVersion "31.0.0"

你在编译的时候AS可能给出如下的错误信息:

Installed Build Tools revision 31.0.0 is corrupted. Remove and install again using the SDK Manager.

那么这就说明你的项目配置中插件版本不匹配了。

那么,需要对应的将项目中的build.gradle中的构建插件升级到7.0.2或者当前(本文发布时间点)的版本7.0.4.

 对应的gradle版本也需要升级,例如下图这样:

 

Gradle 已发布的版本:

Gradle Distributionsicon-default.png?t=LBL2https://services.gradle.org/distributions/

Android Studio版本变化

https://developer.android.com/studio/releases?utm_source=android-studio-2020-3-1&utm_medium=studio-assistant-stable#new-version-numberingicon-default.png?t=LBL2https://developer.android.com/studio/releases?utm_source=android-studio-2020-3-1&utm_medium=studio-assistant-stable#new-version-numbering如果无法访问可以看这个国内镜像网站

Android Studio 版本说明  |  Android 开发者  |  Android Developers

这个错误提示: ``` Installed Build Tools revision 31.0.0 is corrupted. Remove and install again using the SDK Manager. ``` ### 🔴 含义解释: 表示你当前安装的 **Android Build Tools 版本 `31.0.0` 已损坏(corrupted)**,无法正常使用Gradle 构建系统在尝试使用它时检测到文件不完整或校验失败,因此报错并建议你重新安装。 --- ### 📌 什么是 Build Tools? `Build Tools` 是 Android SDK 的一部分,是一套命令行工具,用于编译、打包你的 APK,例如: - `aapt2`:编译资源文件 - `dx` / `d8`:将 Java 字节码转换为 DEX 格式 - `zipalign`:优化 APK 文件 每个版本都有独立的功能和修复,项目中通过 `buildToolsVersion` 指定使用哪个版本。 ```gradle android { compileSdkVersion 31 buildToolsVersion "31.0.0" // ← 就是这个版本出问题了 } ``` --- ### ✅ 解决方案:重新安装 Build Tools 31.0.0 #### 方法一:使用 Android StudioSDK Manager(图形化方式) 1. 打开 Android Studio 2. 进入菜单: - Windows/Linux: `File → Settings → Appearance & Behavior → System Settings → Android SDK` - macOS: `Android Studio → Preferences → Android SDK` 3. 切换到 **SDK Tools** 标签页 4. 找到 `Android SDK Build-Tools`,勾选后击 **Uninstall** 5. 卸载完成后,再次勾选并击 **Install** 6. 等待下载安装完成 > 或者你可以选择其他可用版本(如 `30.0.3`、`33.0.0`),然后修改项目中的 `buildToolsVersion` --- #### 方法二:手动删除目录后重装 有时候即使卸载也不彻底,需要手动清理。 1. 关闭 Android Studio 2. 删除以下目录(路径可能因系统而异): ```text Windows: C:\Users\<你的用户名>\AppData\Local\Android\Sdk\build-tools\31.0.0 macOS: ~/Library/Android/sdk/build-tools/31.0.0 Linux: ~/.android/sdk/build-tools/31.0.0 ``` > ⚠️ 注意:如果你自定义过 SDK 路径,请前往实际路径下删除。 3. 重新打开 Android Studio 4. 再次进入 SDK Manager,重新安装 Build Tools 31.0.0 --- #### 方法三:使用命令行安装(推荐高级用户) 打开终端,使用 `sdkmanager` 命令: ```bash # 查看已安装的 build-tools sdkmanager --list | grep build-tools # 删除旧版本 sdkmanager --uninstall 'build-tools;31.0.0' # 重新安装 sdkmanager --install 'build-tools;31.0.0' ``` > 提示:确保 `sdkmanager` 在环境变量中,或者进入 `$ANDROID_HOME/cmdline-tools/latest/bin/` 目录执行 --- ### ✅ 替代方案:升级 `buildToolsVersion`(可选) Google 官方现在通常不再强制要求指定 `buildToolsVersion`,因为 Gradle 插件会自动选择匹配的版本。 你可以直接 **删除 `buildToolsVersion` 这一行**,让 AGP 自动管理: ```gradle android { compileSdkVersion 31 // buildToolsVersion "31.0.0" ← 删除这一行 } ``` ✅ 推荐做法(尤其是 AGP 7.0+):省略该字段,由插件自动匹配最合适的 Build Tools 版本。 --- ### ❓为什么会发生“corrupted”? 常见原因包括: - 下载过程中网络中断 - 杀毒软件拦截了解压过程 - 磁盘空间不足 - SDK 目录权限问题 - 多人共用一台电脑导致文件被误删或篡改 --- ### ✅ 总结 | 步骤 | 操作 | |------|------| | 1 | 删除损坏的 Build Tools 31.0.0(通过 SDK Manager 或手动删除) | | 2 | 重新安装 `build-tools;31.0.0` | | 3 | 或者:从 `build.gradle` 中移除 `buildToolsVersion` 让 AGP 自动管理 | | 4 | 清理项目:`./gradlew clean` 并重新同步 | ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值