Android Gradle 外掛程式 DSL/API 遷移時程

Android Gradle 外掛程式 (AGP) 是 Android 應用程式支援的建構系統，可支援編譯多種不同來源，並連結至應用程式中，然後在實體 Android 裝置或模擬器上執行。

本節將說明 AGP DSL 和 API 的預計發展。隨著新的 API 在穩定版中推出，舊版 API 會標示為已淘汰。這些已淘汰的 API 會在下一個穩定版中停用。下方是各個主要 AGP 版本即將推出的異動相關資訊。

如要進一步瞭解 AGP API 淘汰或移除的詳細記錄，請參閱「AGP API 更新」。

AGP 9.0 (2026 年 1 月)

新的 Variant API 是穩定版，舊版 API 已淘汰

  • 在 4.1 和 4.2 中發展的 Variant API 是穩定版。
  • 這些介面全都位於 gradle-api 成果中。
  • 先前在舊版 Variant API 中使用的介面和類別現已淘汰，如要使用，必須明確選擇加入。

新版 DSL 介面是穩定版，舊介面已淘汰

  • 在 4.1、4.2 和 7.0 中發展的 DSL 介面現已是穩定版。
  • 這些介面全都位於 gradle-api 成果中。
  • 先前在 DSL 中使用的介面和類別現已淘汰，如要使用，必須明確選擇加入。

仍可存取私人內部 AGP 類別

即使是在其他構件中的 AGP 私人內部類別，在建構檔案和外掛程式編譯期間仍可存取，但不建議使用，因為這些類別可能隨時發生破壞性改變。

AGP 10.0 (2026 年底)

舊版 API 已移除

  • 先前在 DSL 和舊版 Variant API 中使用的介面和類別都已刪除。
  • 您只需要 gradle-api 構件，就能存取 DSL 和變數 API 介面和類別，並在開發外掛程式時使用。

(暫定) 私人內部 AGP 類別的存取權已移除

現在依附於 gradle 成果已無法取用所有內部類別，且只能取得 gradle-api 成果中可用介面和類別的編譯存取權。這會影響外掛程式編譯。

您無法手動新增依附元件來取得內部類別的存取權。