使用compileSdk=33时需更新Android Gradle Plugin的问题咨询

核心前提 #

Android Gradle Plugin（AGP）7.2.1最高仅支持compileSdk 32，要适配compileSdk 33，必须升级到AGP 7.3.0及以上版本，同时要保证AGP与Gradle版本严格匹配。

具体更新步骤 #

1. 升级根目录build.gradle中的AGP版本 #

打开项目根目录的build.gradle文件，修改dependencies块里的AGP版本：

buildscript {
    dependencies {
        // 替换为适配compileSdk 33的版本，比如7.3.1（稳定版）
        classpath 'com.android.tools.build:gradle:7.3.1'
    }
}

2. 同步升级Gradle版本 #

AGP版本与Gradle版本必须对应，比如AGP 7.3.x需要Gradle 7.4+。打开gradle-wrapper.properties文件，修改distributionUrl：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.4.2-bin.zip

3. 检查仓库配置 #

确保根目录settings.gradle中配置了谷歌仓库，否则无法下载AGP新版本：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google() // 必须添加，AGP插件仅在此仓库发布
        mavenCentral()
    }
}

4. 同步项目 #

点击Android Studio右上角的「Sync Project with Gradle Files」按钮，完成同步。如果同步失败，查看日志排查网络或依赖问题。

常见遗漏点 #

• 只修改AGP版本但未对应升级Gradle，导致版本不兼容
• 未在settings.gradle中配置google()仓库，无法拉取新插件
• 修改配置后未执行Gradle同步，插件版本未实际更新

内容的提问来源于stack exchange，提问作者Compose Learner