Android v1 embedding app and plugin creation deprecation
Summary
#The flutter create
templates for apps and plugins
no longer create Android wrapping based on the
v1 Android embedding as part of our gradual
Android v1 embedding deprecation process described in our
Android Migration Summary.
Application projects using the v1 Android embedding are encouraged to migrate following the steps described in Upgrading pre 1.12 Android projects.
Plugins targeting the v1 Android embedding are encouraged to migrate following the instructions in Supporting the new Android plugins APIs.
Context
#In Flutter version 1.12, we launched a v2 set of
Android APIs based on the io.flutter.embedding
package in order to enable the add-to-app workflow
on Android.
Over time, we gradually deprecated the older
v1 Android embeddings based on the
io.flutter.app
package.
As of Q2 2020, only 26% of applications used the v1 embeddings.
Since the v2 embeddings were strongly established over the 7 months since the launch of Flutter v1.12, we disabled the creation of new app and plugin projects using the v1 embeddings.
Description of change
#The flutter config
command no longer has a
toggleable enable-android-embedding-v2
flag (which defaulted to true since v1.12).
All projects created with flutter create
and flutter create -t plugin
exclusively use the
Android v2 embedding.
Existing v1 applications continue to work.
Existing v1 applications consuming plugins now receive a warning prompt to migrate to v2 embedding.
Existing v1 applications consuming a plugin that targets only the v2 embedding won't build and must migrate. This has been the case since v1.12. However, the likelihood of encountering this increases as plugin developers create and publish v2 only plugins.
Existing v2 applications continue to work with or without plugins.
Existing v2 applications consuming plugins that only target the v1 embedding continue to receive a warning prompt. The likelihood of encountering this decreases as plugin developers create and publish v2 plugins.
Migration guide
#For more information, see Upgrading pre 1.12 Android projects.
Timeline
#除非另有说明,本文档之所提及适用于 Flutter 的最新稳定版本,本页面最后更新时间: 2024-09-04。 查看文档源码 或者 为本页面内容提出建议。