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 不適用 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.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 外掛程式
如果沒有 it.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) 模組也支援使用來源集定義消費者規則。