The project is using an incompatible version (AGP x.x.x) of the Android Gradle plugin

今天在编译一个 github 上的 Android 项目时，报错

The project is using an incompatible version (AGP 8.1.0) of the Android Gradle plugin. Latest supported version is AGP 8.0.1

AGP 是什么

Android Gradle Plugin。

AGP（Android Gradle Plugin）是一个用于构建 Android 应用程序的 Gradle 插件。AGP 可以将 Android 项目中的源代码、资源和依赖项编译成可安装的 APK 文件，并提供了许多其他功能，例如代码混淆、资源压缩、多渠道打包等。

通过 AGP，可以轻松地管理项目依赖、配置构建选项、处理多个变体等。

AGP 的版本通常与 Android Studio 的版本号保持一致，例如 Android Studio 4.2 通常使用 AGP 4.2。每个版本的 AGP 都会引入一些新功能和改进，因此建议使用最新版本的 AGP 来构建应用程序。

Android Studio 与对应的 AGP 版本

https://developer.android.com/studio/releases?hl=zh-cn#android_gradle_plugin_and_android_studio_compatibility

解决方法

如果不想升级 Android Studio 版本，可以通过修改 project gradle 中的配置解决：

例如：build.gradle.kts

buildscript {
    repositories {
        maven { url = uri("https://plugins.gradle.org/m2/") }
        maven { url = uri("https://maven.aliyun.com/nexus/content/repositories/google") }
        maven { url = uri("https://maven.aliyun.com/nexus/content/groups/public") }
        maven { url = uri("https://maven.aliyun.com/nexus/content/repositories/jcenter") }
        google()
        mavenCentral()
        jcenter()
    }
    dependencies {
        classpath(Libraries.Gradle.Kotlin)
        //classpath(Libraries.Gradle.Android)   // 注释掉这行
        classpath("com.android.tools.build:gradle:8.0.1")   // 增加这行，指定版本 
        classpath(AndroidX.Navigation.safeArgsGradlePlugin)
    }
}

关于作者 🌱

我是来自山东烟台的一名开发者，有敢兴趣的话题，或者软件开发需求，欢迎加微信 zhongwei 聊聊， 查看更多联系方式