升级Xcode 14.3.1后Pod依赖框架丢失问题求助

问题说明 #

项目在升级Xcode至14.3.1前运行完全正常，升级后出现以下异常：

• Xcode导航栏内框架文件名显示红色，无法定位对应文件
• 构建项目后控制台抛出框架找不到的错误
• 已尝试两种常规解决方案，但均未生效

可行解决步骤 #

1. 彻底重置Pods并重新安装 #

关闭Xcode，在终端进入项目根目录，依次执行以下命令：

pod deintegrate
rm -rf Podfile.lock
rm -rf ~/Library/Caches/CocoaPods
rm -rf ./Pods
pod install

安装完成后，必须打开项目的.xcworkspace文件，不要直接打开.xcodeproj。

2. 修正Build Settings路径配置 #

进入项目的Build Settings页面，依次进行以下操作：

• 搜索Framework Search Paths，删除原有无效路径，添加$(inherited)和$(PROJECT_DIR)/Pods/**，并将路径类型设置为recursive（递归）
• 搜索Library Search Paths，重复上述操作，添加相同的路径并设置为递归

3. 重新配置Target框架依赖 #

进入项目Target的General标签页：

• 在Frameworks, Libraries, and Embedded Content区域，移除所有显示红色的框架条目
• 点击+按钮，从项目的Pods/Products目录中重新添加对应的框架文件
• 根据框架类型设置Embed选项：第三方Pods框架一般选择Embed & Sign，系统框架选择Do Not Embed

4. 清理Xcode缓存 #

• 在终端执行命令清理Xcode衍生数据：

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

• 打开Xcode，点击菜单栏Product -> Clean Build Folder（快捷键Shift+Command+K）

5. 确保Pods版本与Xcode兼容 #

• 在终端执行pod --version查看当前CocoaPods版本
• 如果版本较低，执行sudo gem install cocoapods升级到最新版本，之后重新执行pod install

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