如何安装旧版AGP以适配Java 11与Gradle 5环境？

一、先理清版本兼容逻辑 #

AGP 3.3.0本身支持Gradle 4.10.1~5.6.4区间版本，也支持Java 11作为编译JDK。你找不到AGP 3.3.0的核心问题是仓库配置不全，而非版本下架。

二、手动配置现有项目的完整步骤 #

1. 修复AGP 3.3.0的下载问题 #

在项目根目录的settings.gradle.kts中，补全仓库配置（老版本AGP依赖这些仓库）：

pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

接着在根目录build.gradle.kts中指定AGP版本：

plugins {
    id("com.android.application") version "3.3.0" apply false
    id("com.android.library") version "3.3.0" apply false
}

2. 锁定Gradle 5.x稳定版 #

修改gradle/wrapper/gradle-wrapper.properties，替换为Gradle 5系列最后一个稳定版（兼容性最好）：

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.4-all.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

3. 配置Java 11编译环境 #

在模块级build.gradle.kts中添加Java 11编译规则：

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_11
        targetCompatibility = JavaVersion.VERSION_11
    }
    // 若使用Kotlin，需额外添加
    kotlinOptions {
        jvmTarget = "11"
    }
}

同时打开Android Studio的File > Project Structure > Project，把SDK Location > JDK Location设置为Java 11的安装路径。

4. 处理同步报错 #

• 若依赖下载失败，执行File > Invalidate Caches... > Invalidate and Restart清理Gradle缓存
• 建议使用Android Studio 4.2.x版本，太新的AS对老AGP兼容性较差

三、直接创建符合配置的新项目 #

1. 打开Android Studio，选择New Project，选基础模板（比如Empty Activity）
2. 项目创建后，直接按照上面的步骤1-3修改AGP、Gradle和Java版本配置
3. 同步项目即可

注意：AGP 3.3.0最高支持compileSdkVersion 29，不要设置过高的SDK版本

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