Xcode项目中CocoaPods框架缺失问题求助

我创建了一个全新的iOS游戏应用，使用指定Podfile执行pod install命令后，项目里出现了缺失的框架引用。虽然项目能正常构建和运行，但我在导航器中删除这些引用后，再次执行pod install它们又会恢复。我用的是M1 MacBook，不确定这是不是ARM架构下的预期行为，有没有人遇到过类似情况？

我的运行环境：

• CocoaPods: 1.13.0
• Ruby: ruby 3.2.2 (2023-03-30 revision e51014f9c0) [arm64-darwin22]
• RubyGems: 3.4.10
• Host: macOS 13.4.1 ((c))
• Xcode: 14.3.1 (14E300c)
• Git: git version 2.39.2 (Apple Git-143)
• Ruby lib dir: /opt/homebrew/Cellar/ruby/3.2.2_1/lib

1. 处理Pod的隐式依赖 #

部分第三方Pod会隐式依赖系统框架，CocoaPods会自动添加这些引用，但ARM架构下可能因SDK路径问题显示框架缺失。可以在Podfile中添加脚本移除不必要的框架引用：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      # 将"缺失的框架名"替换成实际框架名称，可多次添加删除逻辑
      config.build_settings['OTHER_LDFLAGS'] = config.build_settings['OTHER_LDFLAGS'].delete('-framework "缺失的框架名"')
    end
  end
end

2. 清理缓存与重置项目配置 #

M1架构下缓存异常可能导致这类问题，执行以下命令彻底清理后重新安装：

# 清空所有Pod缓存
pod cache clean --all
# 删除Pod锁定文件和Pods目录
rm -rf Podfile.lock Pods
# 删除Xcode派生数据
rm -rf ~/Library/Developer/Xcode/DerivedData
# 重新执行安装
pod install

3. 强制适配ARM架构执行命令 #

尝试用ARM架构指令执行pod install，避免架构兼容问题：

arch -arm64 pod install

同时可在Podfile中添加架构过滤配置，减少不必要的框架引用：

post_install do |installer|
  installer.pods_project.build_configurations.each do |config|
    config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = "arm64"
  end
end

4. 检查Xcode命令行工具路径 #

ARM架构下Xcode的SDK路径可能存在异常，打开Xcode的Preferences > Locations，确认Command Line Tools选择的是14.3.1版本，再执行：

xcode-select --reset

5. 更新CocoaPods到最新版本 #

1.13.0版本可能存在ARM架构下的小bug，尝试升级到最新稳定版：

gem install cocoapods

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