1. 程式人生 > 實用技巧 >Android Gradle 外掛版本與Gradle版本對應

Android Gradle 外掛版本與Gradle版本對應

Android 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
...