升级Xcode 15后添加Extension出现<Flutter/Flutter.h>文件未找到错误

问题背景 #

升级Xcode 15后，给Flutter项目添加Extension时出现编译错误：<Flutter/Flutter.h> file not found，试过重建iOS目录、清理缓存、重新安装Pods等常规操作都没解决。

可行解决方案 #

调整Extension的Build路径配置 #

1. 打开Xcode选中你的Extension target
2. 进入Build Settings，搜索Header Search Paths
3. 添加以下路径（勾选递归搜索）：

   $(inherited)
   $(SRCROOT)/../flutter/ios/Flutter
   $(SRCROOT)/../.symlinks/flutter/ios/Flutter
   

4. 同样搜索Framework Search Paths，添加上述相同路径
5. 把Always Search User Paths设为YES

修正Podfile的Extension目标配置 #

在项目ios/Podfile里给Extension target添加Flutter依赖：

target '你的Extension名称' do
  use_frameworks!
  use_modular_headers!

  # 新增这两行
  pod 'Flutter', :path => '../flutter'
  pod 'FlutterPluginRegistrant', :path => '../flutter/packages/flutter_plugin_registrant'

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
end

然后在ios目录执行：

pod deintegrate
pod install

切换Xcode构建系统 #

1. 点击Xcode顶部菜单栏的File > Workspace Settings（如果是项目则选Project Settings）
2. 把Build System从默认的New Build System改成Legacy Build System
3. 清理编译缓存后重新编译

升级Flutter版本 #

Xcode 15要求Flutter版本至少3.13.0及以上，执行升级：

flutter upgrade

验证操作 #

做完上面任意一种方案后，按以下步骤验证：

• 终端执行flutter clean和flutter pub get
• Xcode里选Product > Clean Build Folder
• 重新编译运行Extension目标

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