Android Gradle 插件版本與Gradle版本對應

原：https://developer.android.google.cn/studio/releases/gradle-plugin.html#updating-plugin

Android Studio 構建系統以 Gradle 為基礎，並且 Android Gradle 插件添加了幾項專用於構建 Android 應用的功能。雖然 Android 插件通常會與 Android Studio 的更新步調保持一致，但插件（以及 Gradle 系統的其余部分）可獨立於 Android Studio 運行並單獨更新。

本頁將介紹如何讓 Gradle 工具保持最新狀態，以及最近的更新都包含哪些內容。

如需詳細了解如何使用 Gradle 配置 Android build，請參閱以下頁面：

要詳細了解 Gradle 構建系統，請參閱 Gradle 用戶指南。

更新 Android Gradle 插件

在更新 Android Studio 時，您可能會收到將 Android Gradle 插件自動更新為最新可用版本的提示。您可以選擇接受該更新，也可以根據項目的構建要求手動指定版本。

您可以在 Android Studio 的 File > Project Structure > Project 菜單中指定插件版本，也可以在頂級 build.gradle 文件中進行指定。該插件版本適用於在相應 Android Studio 項目中構建的所有模塊。以下示例從 build.gradle 文件中將插件的版本設置為 3.6.0：

    buildscript {
        repositories {
            // Gradle 4.1 and higher include support for Google's Maven repo using
            // the google() method. And you need to include this repo to download
            // Android Gradle plugin 3.0.0 or higher.
            google()
            ...
        }
        dependencies {
            classpath 'com.android.tools.build:gradle:3.6.0'
        }
    }

注意：請勿在版本號中采用動態依賴項（例如 'com.android.tools.build:gradle:2.+'），否則可能會導致意外的版本更新和難以解析的版本差異。

如果指定的插件版本尚未下載，則 Gradle 會在您下次構建項目時進行下載；或者，您也可以在 Android Studio 菜單欄中依次點擊 Tools > Android > Sync Project with Gradle Files 進行下載。

更新 Gradle

在更新 Android Studio 時，您可能會收到一並將 Gradle 更新為最新可用版本的提示。您可以選擇接受該更新，也可以根據項目的構建要求手動指定版本。

下表列出了各個 Android Gradle 插件版本所需的 Gradle 版本。要獲得最佳性能，您應該使用 Gradle 和插件這兩者的最新版本。

插件版本	所需的 Gradle 版本
1.0.0 - 1.1.3	2.2.1 - 2.3
1.2.0 - 1.3.1	2.2.1 - 2.9
1.5.0	2.2.1 - 2.13
2.0.0 - 2.1.2	2.10 - 2.13
2.1.3 - 2.2.3	2.14.1+
2.3.0+	3.3+
3.0.0+	4.1+
3.1.0+	4.4+
3.2.0 - 3.2.1	4.6+
3.3.0 - 3.3.2	4.10.1+
3.4.0 - 3.4.1	5.1.1+
3.5.0-3.5.3	5.4.1+
3.6.0+	5.6.4+

您可以在 Android Studio 的 File > Project Structure > Project 菜單中指定 Gradle 版本，也可以通過在 gradle/wrapper/gradle-wrapper.properties 文件中修改 Gradle 分發引用來指定。以下示例在 gradle-wrapper.properties 文件中將 Gradle 的版本設置為 5.4.1。

...
distributionUrl = https\://services.gradle.org/distributions/gradle-5.4.1-all.zip
...