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 不適用 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)
應用程式 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 執行速度過快