Flutter插件Android嵌入版本过期报错排查求助

1. 清理缓存与构建产物 #

执行以下命令彻底清除残留的缓存和旧构建文件，消除跨平台构建的缓存冲突：

flutter clean
rm -rf ios/Pods ios/Podfile.lock pubspec.lock
flutter pub get
cd ios && pod install --repo-update

2. 检查插件依赖链 #

部分插件本身支持V2嵌入，但间接依赖的子库可能仍在使用V1嵌入。用以下命令查看完整依赖树：

flutter pub deps --tree

重点排查报错列表中的插件，比如device_info已被官方弃用，确认项目是否直接/间接残留了该插件的依赖。

3. 验证Android嵌入配置 #

检查android/app/src/main/AndroidManifest.xml和主Activity代码，确保V2嵌入配置正确：

• <application>标签内必须包含：

  <meta-data
      android:name="flutterEmbedding"
      android:value="2" />
  

• MainActivity需继承FlutterFragmentActivity而非旧的FlutterActivity：

  class MainActivity : FlutterFragmentActivity() {
      // ...
  }
  

4. 锁定插件版本并排查版本漂移 #

• 打开pubspec.yaml，确认所有报错插件的版本已明确锁定（如firebase_analytics: ^8.3.4，避免使用any）。
• 查看pubspec.lock中插件的实际安装版本，确认是否与预期一致——依赖解析可能因版本约束冲突自动拉取旧版本。

5. 排查Flutter SDK版本异常 #

执行flutter --version确认当前SDK版本，切换到稳定版并更新：

flutter channel stable
flutter upgrade

即使未主动升级，IDE自动切换通道、依赖拉取时的隐性更新都可能导致SDK版本变化，新版本对V1嵌入的检测更严格。

6. 逐一移除可疑插件定位问题 #

先移除明确废弃的插件（如device_info），重新运行项目验证是否报错。若问题消失，再逐个加回其他插件，定位到具体触发问题的插件或其依赖。

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