跳到主要內容

Android v1 嵌入應用程式與外掛程式建立的棄用

摘要

#

應用程式和外掛程式的 flutter create 範本,不再根據 v1 Android 嵌入建立 Android 包裝,這是我們 Android 移轉摘要 中描述的逐步棄用 Android v1 嵌入過程的一部分。

建議使用 v1 Android 嵌入的應用程式專案,按照 升級 pre 1.12 Android 專案 中描述的步驟進行移轉。

我們鼓勵以 v1 Android 嵌入為目標的插件,按照支援新的 Android 插件 API中的說明進行遷移。

情境

#

在 Flutter 1.12 版本中,我們推出了基於 io.flutter.embedding 套件的 v2 Android API,以在 Android 上啟用加入應用程式工作流程。

隨著時間的推移,我們逐漸棄用了基於 io.flutter.app 套件的舊版 v1 Android 嵌入。

截至 2020 年第二季,只有 26% 的應用程式使用 v1 嵌入。

由於 v2 嵌入在 Flutter v1.12 發布後的 7 個月內已牢固建立,因此我們停用了使用 v1 嵌入建立新應用程式和插件專案的功能。

變更說明

#

flutter config 命令不再具有可切換的 enable-android-embedding-v2 標誌(自 v1.12 起預設為 true)。所有使用 flutter createflutter create -t plugin 建立的專案都專門使用 Android v2 嵌入。

現有的 v1 應用程式仍可繼續運作。

現有使用插件的 v1 應用程式現在會收到警告提示,要求遷移到 v2 嵌入。

現有使用僅以 v2 嵌入為目標的插件的 v1 應用程式將無法建置,並且必須遷移。自 v1.12 起就已如此。但是,隨著插件開發人員建立並發布僅限 v2 的插件,遇到這種情況的可能性會增加。

現有的 v2 應用程式無論有無插件都可以繼續運作。

現有的 v2 應用程式使用僅以 v1 嵌入為目標的插件時,會繼續收到警告提示。隨著插件開發人員建立並發布 v2 插件,遇到這種情況的可能性會降低。

移轉指南

#

更多資訊,請參閱升級 1.12 之前的 Android 專案

時程

#

已於版本中推出:1.20.0-8.0
於穩定版本中推出:1.22