Flutter 升級 Gradle 和 Gradle Plugin

目前 Flutter3.0 預設的 Gradle 版本是 7.5，當然也有可能會更早一些。有時候因為某些需求要升級 Gradle 到新版本。本文以升級到 8.2.1 版本舉例，會講述 Flutter 項目中升級 Gradle 和 Gradle Plugin 以及 android tools、設置鏡像源等問題。

Gradle Plugin 版本匹配

不同的 Gradle 版本所匹配的 Gradle Plugin 版本是不一樣的。官方給了個表格插件版本對應。

根據官方說明，Gradle Plugin 的 7.4.2 是一個主要版本，並且相容 Gradle 8.2.1。

Flutter 工程修改

升級 Gradle 版本很容易，在android/gradle/wrapper/gradle-wrapper.properties文件中，將distributionUrl改為新版本的地址，以 8.2.1 舉例為https\://services.gradle.org/distributions/gradle-8.2.1-all.zip。此時該文件如下：

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

升級 Gradle Plugin 並設置鏡像

首先修改android/settings.gradle文件如下，增加阿裡雲的 Gradle Plugin 鏡像源。

pluginManagement {
    repositories {
        maven{
            url 'https://maven.aliyun.com/repository/gradle-plugin'
        }
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

再修改android/build.gradle文件，增加阿裡雲鏡像源，並將 Gradle Plugin 版本設置為 7.4.0

buildscript {
    ext.kotlin_version = '1.7.10'
    repositories {
        maven {
            url 'https://maven.aliyun.com/repository/public/'
        }
        maven {
            url 'https://maven.aliyun.com/repository/central'
        }
        maven{
            url 'https://maven.aliyun.com/repository/gradle-plugin'
        }
        google()
        mavenCentral()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:7.4.0'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

allprojects {
    repositories {
        maven {
            url 'https://maven.aliyun.com/repository/public/'
        }
        maven {
            url 'https://maven.aliyun.com/repository/central'
        }
        maven{
            url 'https://maven.aliyun.com/repository/gradle-plugin'
        }
        google()
        mavenCentral()
    }
}

編譯項目，會自動升級新版本。