概述

#

为了逐步弃用 Android v1 嵌入,我们已不再使用 v1 Android 嵌入为应用和插件创建 flutter create 模板。更多信息请参阅我们的 Android 迁移摘要

我们鼓励使用 v1 Android 嵌入的应用项目按照 升级 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 嵌入。

自 Flutter v1.12 发布以来,v2 嵌入已发布 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 应用程序(无论是否使用插件)将继续正常工作。

使用仅支持 v1 嵌入的插件的现有 v2 应用程序将继续收到警告提示。随着插件开发者创建和发布 v2 插件,遇到这种情况的可能性会降低。

迁移指南

#

更多信息,请参阅 升级 1.12 之前的 Android 项目

时间线

#

已包含在版本中:1.20.0-8.0
稳定发布版本:1.22