Flutter Android构建成功后卡在闪屏，插件涉旧版Android嵌入问题

核心原因定位 #

日志明确提示flutter_keyboard_visibility插件使用了已废弃的Android V1嵌入方案。Flutter 3.x版本对V1嵌入的兼容性大幅下降，尤其在Android 11及以上系统中，会阻塞App启动流程，直接导致闪屏卡死。

具体解决步骤 #

1. 升级目标插件到兼容V2嵌入的版本 #

• 打开项目根目录下的pubspec.yaml，找到flutter_keyboard_visibility的依赖条目，替换为支持Android V2嵌入的最新稳定版（例如flutter_keyboard_visibility: ^5.4.1，需确认兼容Flutter 3.3.5）
• 执行命令：flutter pub get更新依赖
• 若升级后仍有异常，查看插件官方文档，确认是否需要补充Android端配置（如修改MainActivity继承类、调整AndroidManifest.xml配置）

2. 替换插件（升级不可行时） #

如果该插件已停止维护无法升级，直接替换为维护活跃、支持V2嵌入的同功能插件，或自行实现轻量键盘监听逻辑：

• 替代插件示例：选择标注支持Flutter 3.x及Android V2嵌入的键盘状态监听插件
• 自行实现：通过Flutter原生的MediaQuery.of(context).viewInsets.bottom判断键盘是否弹出，无需依赖第三方插件

3. 验证Android嵌入配置 #

• 检查android/app/src/main/kotlin/[包名]/MainActivity.kt（或Java版本），确保Activity继承自io.flutter.embedding.android.FlutterActivity（V2嵌入标准实现），而非旧版V1的FlutterActivity
• 清理AndroidManifest.xml中残留的V1嵌入配置项（如旧的meta-data标签）

额外排查点 #

• 检查其他插件兼容性：执行flutter pub outdated，排查所有依赖插件是否存在V1嵌入问题，统一升级到兼容版本
• 清理构建缓存：执行flutter clean后重新构建，避免旧缓存文件干扰
• 核对Gradle配置：确认app/build.gradle中compileSdkVersion≥33、minSdkVersion≥16（符合Flutter 3.3.5的官方要求）

内容的提问来源于stack exchange，提问作者Neo