Android v1 embedding 應用程式與插件建立棄用公告
Android v1 embedding 的逐步棄用。
摘要
#
flutter create 應用程式與插件的範本
不再基於 v1 Android embedding 建立 Android 包裝,
這是我們依據
Android 遷移摘要
所描述的 Android v1 embedding 逐步棄用流程的一部分。
建議使用 v1 Android embedding 的應用程式專案, 依照升級 1.12 之前的 Android 專案 中所述的步驟進行遷移。
針對 v1 Android embedding 的插件也建議 依照支援新版 Android 插件 API 中的說明進行遷移。
背景說明
#
在 Flutter 1.12 版本中,我們推出了一組基於 io.flutter.embedding
套件的 v2 Android API,
以支援 Android 上的 add-to-app 工作流程。
隨著時間推移,我們逐步棄用了舊有
基於 io.flutter.app
套件的 v1 Android embedding。
截至 2020 年第二季,僅有 26% 的應用程式仍使用 v1 embedding。
自 Flutter v1.12 推出後的 7 個月內,v2 embedding 已被廣泛採用, 因此我們已停用使用 v1 embedding 建立新應用程式與插件專案的功能。
變更說明
#
flutter config 指令已不再提供
可切換的 enable-android-embedding-v2
旗標(自 v1.12 起預設為 true)。
所有以 flutter create
與 flutter create -t plugin 建立的專案皆僅使用
Android v2 embedding。
既有的 v1 應用程式仍可正常運作。
既有的 v1 應用程式若使用插件,現在會收到 建議遷移至 v2 embedding 的警告提示。
既有的 v1 應用程式若使用僅支援 v2 embedding 的插件,將無法建置,必須進行遷移。 這種情況自 v1.12 起即已存在。然而, 隨著插件開發者持續創建並發佈僅支援 v2 的插件, 遇到此情形的機率將會提高。
既有的 v2 應用程式無論是否使用插件,皆可正常運作。
既有的 v2 應用程式若使用僅支援 v1 embedding 的插件,仍會收到警告提示。 隨著插件開發者逐步創建並發佈 v2 插件, 遇到此情形的機率將會降低。
遷移指南
#欲了解更多資訊, 請參閱升級 1.12 之前的 Android 專案。
時程
#
合併進版本:1.20.0-8.0
穩定版本:1.22
Unless stated otherwise, the documentation on this site reflects Flutter 3.44.0. Page last updated on 2026-06-14. View source or report an issue.