Android Gradle 外掛程式 9.3.0 版 (2026 年 7 月)

Android Gradle 外掛程式 9.3 是次要版本，內含多種新功能及改善項目。

相容性

Android Gradle 外掛程式 9.3 支援的最高 API 級別為 37。其他相容性資訊如下：

最低版本 預設版本 附註
Gradle 9.5.0 9.5.0 詳情請參閱「更新 Gradle」一節。
SDK 版本工具 36.0.0 36.0.0 安裝或設定 SDK 建構工具。
NDK N/A 28.2.13676358 安裝或設定 NDK 其他版本。
JDK 17 17 詳情請參閱「設定 JDK 版本」相關說明。

獨立的 R8 設定分析器 Gradle 工作

Android Gradle 外掛程式 9.3 推出專屬的 Gradle 工作，可獨立執行 R8 設定分析器。R8 設定分析器可協助您最佳化應用程式的程式碼縮減和模糊化規則。

./gradlew :app:analyzeReleaseR8Config

:app:analyzeReleaseR8Config 工作會產生報告，但不會完成 APK 或套件編譯管道。這可縮短意見回饋循環，加快開發人員疊代速度，進而改善保留規則。或者，您也可以執行 R8 發布子版本建構 (例如 assembleRelease 或 bundleRelease)，自動產生報表。

詳情請參閱「執行獨立的 Gradle 工作，產生報表」。

已修正問題

Android Gradle 外掛程式 9.3.2 版

已修正問題
Lint
AGP 9.3 Lint 在 JDK 17 上當機 - NoSuchMethodError：在隨附的 intellij-core JavaDocParser 中，java.util.List.removeLast()

Android Gradle 外掛程式 9.3.1 版

已修正問題
AGP 9.3.1 未將任何公開問題標示為已修正

Android Gradle 外掛程式 9.3.0-rc02

已修正問題
AGP 9.3.0-rc02 中沒有標示為已修正的公開問題

Android Gradle 外掛程式 9.3.0-rc01

已修正問題
AGP 9.3.0-rc01 中沒有標示為已修正的公開問題

Android Gradle 外掛程式 9.3.0-alpha12

已修正問題
Android Gradle 外掛程式
建構失敗：compile_library_classes_jar 中的 classes.jar 發生檔案控制代碼洩漏問題，導致 Windows 無法重建，直到 IDE 重新啟動為止
Lint
Lint 會將匯入的 Java 程式庫視為 Android 專案，並忽略編譯 SDK 版本

Android Gradle 外掛程式 9.3.0-alpha11

已修正問題
AGP 9.3.0-alpha11 未標示任何公開問題為已修正

Android Gradle 外掛程式 9.3.0-alpha10

已修正問題
AGP 9.3.0-alpha10 未將任何公開問題標示為已修正

Android Gradle 外掛程式 9.3.0-alpha09

已修正問題
AGP 9.3.0-alpha09 未將任何公開問題標示為已修正

Android Gradle 外掛程式 9.3.0-alpha08

已修正問題
AGP 9.3.0-alpha08 中沒有標示為已修正的公開問題

Android Gradle 外掛程式 9.3.0-alpha07

已修正問題
AGP 9.3.0-alpha07 未標示任何已修正的公開問題

Android Gradle 外掛程式 9.3.0-alpha06

已修正問題
Android Gradle 外掛程式
JavaDocGenerationTask 應使用工作站

Android Gradle 外掛程式 9.3.0-alpha05

已修正問題
縮減器 (R8)
app mapping.txt 未包含 L8 混淆對應

Android Gradle 外掛程式 9.3.0-alpha04

已修正問題
Android Gradle 外掛程式
如果沒有 consumerKeepRules.publish = true，系統會忽略 KMP keepRules 來源集

Android Gradle 外掛程式 9.3.0-alpha03

已修正問題
Android Gradle 外掛程式
將 Gradle 升級至 9.2.0 後，出現「java.lang.ClassNotFoundException: Didn't find class "com.android.tools.r8.RecordTag"」錯誤
Lint
資源縮減功能停用時發生 Lint 錯誤

Android Gradle 外掛程式 9.3.0-alpha02

已修正問題
Android Gradle 外掛程式
功能要求：在 Android Gradle 外掛程式中新增 native_libs_merge_blame_file 支援
Lint
AnnotationDetector 問題訊息中缺少反引號
停用資源縮減功能時發生 Lint 錯誤

Android Gradle 外掛程式 9.3.0-alpha01

已修正問題
Android Gradle 外掛程式
自動生成的版本代碼有問題
AGP：從專案遷移為依附元件標記
Lint
使用 UseKtx 時，Lint 出現偽陽性

Android Gradle 外掛程式 9.3.0 版

已修正問題
AGP 9.3.0 未將任何公開問題標示為已修正

更新最佳化 DSL，以設定 R8 保留規則

推出更新的最佳化 DSL，可為 R8 最佳化設定保留規則，並支援應用程式模組和程式庫模組測試。如要使用更新後的 DSL 設定最佳化功能，請使用新的 optimization 區塊。如果是應用程式，請在應用程式層級的建構指令碼中，設定建構類型 (例如 release 或 debug) 內的 optimization 區塊。更新後的最佳化 DSL 可簡化 R8 設定：

  • 啟用最佳化功能後，系統會同時進行程式碼最佳化和最佳化資源縮減。
  • 您不再需要指定預設的 Android 排除規則檔案。

請注意，系統仍支援舊版 DSL。

導入來源集，定義保留規則

將保留規則放在 src/<variant>/keepRules/ 來源集中，並加上 .keep 的檔案後置字元。更新後的最佳化 DSL 和舊版 DSL 都支援保留規則的來源集。應用程式模組和程式庫模組都支援使用來源集做為保留規則，也可以在 Kotlin Multiplatform (KMP) 模組中定義消費者規則。