升级flutter_native_splash至2.3.8后Xcode编译提示模块未找到求助

核心排查方向与解决步骤 #

1. 彻底清理缓存与依赖 #

• 执行Flutter端清理命令：

  flutter clean
  flutter pub get
  

• 打开Xcode，执行以下操作：
  • 快捷键Cmd+Shift+K清理构建文件夹
  • 删除Derived Data：通过Xcode偏好设置 → Locations → Derived Data路径，手动删除该文件夹下的所有内容

2. 重新生成启动屏资源并检查配置兼容性 #

• 确认pubspec.yaml中的flutter_native_splash配置符合2.3.8版本要求（部分旧版配置字段在新版可能被废弃，比如ios: image需调整为ios: { image: ... }格式，可对照新版配置示例核对）
• 重新生成启动屏资源：

  flutter pub run flutter_native_splash:create
  

3. 修正Xcode项目中的错误引用 #

• 打开Runner/GeneratedPluginRegistrant.m（或.swift）文件，检查是否存在#import <flutter_native_splash/flutter_native_splash.h>（Swift对应import flutter_native_splash）的导入语句，手动删除该行——flutter_native_splash是命令行工具，无需在插件注册文件中导入
• 检查Xcode项目的Build Phases，确认没有多余的flutter_native_splash相关脚本或依赖引用

4. 重新同步Flutter与Xcode项目配置 #

• 执行命令让Flutter重新生成iOS项目配置：

  flutter build ios --config-only
  

• 关闭Xcode，重新打开ios/Runner.xcworkspace（注意必须打开xcworkspace而非xcodeproj）

5. 版本降级验证（备选） #

如果以上步骤无效，暂时将pubspec.yaml中的版本改回flutter_native_splash: ^2.1.6，执行flutter pub get后重新构建，确认是否为版本升级导致的兼容性问题，再对照官方更新日志排查适配点

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