Android Gradle 外掛程式 9.4.0 版 (2026 年 9 月)

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

相容性

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

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

停用 Variant API 模組

自 AGP 10 起，所有專案都必須使用新的 Variant API。如要支援逐步遷移，您可以在 AGP 10 之前，將下列內容套用至 gradle.properties 檔案，暫時讓特定模組不符合這項規定。

android.newDsl.optOut=:example-lib1

動態功能與 Android 應用程式之間嚴格的 1:1 變體同位性

從 AGP 9.4 開始，建構系統會檢查 Android 應用程式模組和動態功能模組之間是否嚴格遵守 1:1 的版本維度同位，並將任何缺少、額外或不相符的維度回報為建構警告。為協助您準備迎接更嚴格的驗證，同時避免現有建構管道中斷，這項檢查預設會以警告模式運作，但只要啟用 android.enforceDynamicFeatureVariantMatching=true Gradle 選項，就能將檢查升級為執行錯誤。從 AGP 10.0 開始，系統會預設強制執行嚴格的 1:1 變數同位檢查，將基本應用程式與動態功能模組之間的所有維度不符情形，都視為導致建構失敗的重大錯誤。

已修正問題

Android Gradle 外掛程式 9.4.0-alpha04

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

Android Gradle 外掛程式 9.4.0-alpha03

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

Android Gradle 外掛程式 9.4.0-alpha02

已修正問題
Android Gradle 外掛程式
AGP SigningConfig 過於急切
使用在動態功能模組中定義的供應器執行 `./gradlew :app:connectedDebugAndroidTest` 時，會顯示「Unable to get provider」(ClassNotFoundException)

Android Gradle 外掛程式 9.4.0-alpha01

已修正問題
Android Gradle 外掛程式
AGP SigningConfig 過於急切