Android Studio已更新仍提示AGP 8.8.0版本不兼容（支持至8.7.3）

直接通过Android Studio修改AGP版本 #

• 打开Android Studio，使用快捷键Ctrl+Alt+Shift+S（Windows/Linux）或Cmd+;（Mac）打开Project Structure面板
• 左侧选择Project，找到Android Gradle Plugin Version下拉框，选择8.7.3后点击OK，AS会自动同步并修改对应的配置文件

手动定位并修改build.gradle文件 #

• 项目无法构建时AS可能隐藏部分文件，直接到项目本地目录操作：
  1. 找到项目根目录，打开其中的build.gradle（项目级，不是模块下的）
  2. 找到plugins代码块，将AGP版本改为8.7.3，示例代码：

     plugins {
         id 'com.android.application' version '8.7.3' apply false
         id 'com.android.library' version '8.7.3' apply false
         id 'org.jetbrains.kotlin.android' version '1.9.20' apply false
     }
     

  3. 保存文件后回到AS，点击顶部的Sync Now按钮同步项目

清理缓存并强制同步 #

• 若修改后仍有异常，执行File > Invalidate Caches... > Invalidate and Restart，清理AS缓存并重启
• 重启后再次同步项目，确保Gradle下载对应版本的依赖包

版本匹配提示 #

AGP 8.7.3需要搭配Gradle 8.5使用，若同步时提示Gradle版本不兼容，可修改gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

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

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