Xcode中Capacitor-Swift.h缺失及CocoaPods与Capacitor构建问题

一、修复Capacitor/Capacitor-Swift.h及CAPPluginCall相关错误 #

这类错误核心是Capacitor的Swift-Objective-C桥接机制未正常工作，或核心框架未正确集成，按以下步骤逐一排查：

1. 彻底重置CocoaPods依赖 #

进入项目的ios目录，执行以下命令清理并重建Pods：

rm -rf Podfile.lock Pods
pod deintegrate
pod install

同时确认Podfile中Capacitor的引用正确（Capacitor CLI生成的Podfile默认已配置，若手动修改过需核对）：

use_frameworks!
platform :ios, '15.0'

target 'App' do
  pod 'Capacitor', :path => '../../node_modules/@capacitor/ios'
  pod 'CapacitorCordova', :path => '../../node_modules/@capacitor/ios'
  # 其他Capacitor插件依赖
end

2. 完善Xcode构建配置 #

• 框架/头文件搜索路径：在主项目的Build Settings中，确保以下项包含$(inherited)：
  • Header Search Paths：手动添加${PODS_ROOT}/Capacitor（若未自动生成）
  • Framework Search Paths：确认包含$(inherited)和${PODS_ROOT}/Capacitor
• 模块定义检查：除主项目的Defines Module设为Yes，还要检查Pods项目下Capacitor目标的Defines Module是否为Yes：
  1. 展开Xcode左侧导航栏的Pods -> Capacitor
  2. 进入Build Settings，搜索Defines Module并设置为Yes
• 正确导入头文件：Objective-C代码中引用Capacitor API时，应使用#import <Capacitor/Capacitor.h>，无需手动导入Capacitor-Swift.h（该文件由Xcode自动生成）

3. 清理Xcode缓存与构建数据 #

• 删除Xcode派生数据：

  rm -rf ~/Library/Developer/Xcode/DerivedData
  

• 在Xcode中执行Product -> Clean Build Folder（快捷键Shift+Cmd+K），重启Xcode后重新构建

4. 排查自定义插件兼容性 #

若项目包含自定义Capacitor插件：

• 确认插件代码适配Capacitor 6.x版本：Capacitor 6对Objective-C与Swift的交互逻辑有调整，旧版插件可能引用了已废弃的API（如CAPPluginCall的类别定义）
• 检查插件的依赖配置，确保Capacitor版本与项目一致（6.1.2）

二、修复[CP] Embed Pods Frameworks警告 #

该警告因脚本未指定输出文件导致重复执行，解决步骤：

1. 在Xcode左侧导航栏选择主项目，进入Build Phases
2. 找到[CP] Embed Pods Frameworks脚本并展开
3. 点击Output Files下方的+按钮，添加路径：

   $(TARGET_BUILD_DIR)/$(FRAMEWORKS_FOLDER_PATH)
   

4. 保存配置后重新构建，警告将消失

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