Skip to content

回退 AGP 版本到 4.1.3

本文介绍在 使用 uiextensions_src 源码工程的前提下,如何将 Android Gradle Plugin(AGP)从 8.5.1 回退到 4.1.3。

背景说明

自 SDK v9.1 起,为更好支持 Android 16 KB 设备,AGP 从 4.1.3 升级至 8.5.1,并要求 Android Studio 使用 Koala | 2024.1.1 或更高版本。

如果您不希望升级 AGP/Android Studio,且项目基于 uiextensions_src 进行源码集成,可按下述方式在 uiextensions_src 工程中回退 AGP 版本。

操作步骤(uiextensions_src 工程)

1) 在 build.gradle 中将 AGP 回退到 4.1.3

kotlin
dependencies {
    classpath 'com.android.tools.build:gradle:4.1.3'
    // classpath 'com.android.tools.build:gradle:8.5.1'
}

2) 在 gradle-wrapper.properties 中将 Gradle 回退到 6.7

properties
distributionUrl=https\://services.gradle.org/distributions/gradle-6.7-bin.zip
# distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip

3)(可选)移除 namespace,并调整 compileSdk/minSdk/targetSdk

kotlin
android {
    // namespace 'com.foxit.uiextensions'
    compileSdk 33

    defaultConfig {
        minSdk 19
        targetSdk 33
        versionCode 29
        versionName "9.1.0"
        consumerProguardFiles 'proguard-rules.pro'
    }

    // ...
}

4) 调整部分依赖版本

kotlin
dependencies {
    implementation 'androidx.appcompat:appcompat:1.3.1'
    implementation 'com.google.android.material:material:1.4.0'

    // implementation 'androidx.appcompat:appcompat:1.7.0'
    // implementation 'com.google.android.material:material:1.12.0'
    // ...
}

5) 将 JDK 版本降至 17 以下

例如使用 JDK 11JDK 8