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