Android v1 嵌入式应用和插件创建的弃用
摘要
#flutter create
用于创建应用和插件的模板不再基于 v1 Android 嵌入创建 Android 封装,这是我们逐步弃用 Android v1 嵌入过程的一部分,详见我们的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 嵌入。
由于 v2 嵌入在 Flutter v1.12 发布后的 7 个月中得到了稳固发展,我们禁用了使用 v1 嵌入创建新的应用和插件项目。
变更说明
#flutter config
命令不再具有可切换的 enable-android-embedding-v2
标志(自 v1.12 起默认为 true)。所有使用 flutter create
和 flutter 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
除非另有说明,否则本网站上的文档反映的是 Flutter 的最新稳定版本。页面最后更新于 2025-01-30。 查看源代码 或 报告问题。