Xcode 15构建错误：SDK不包含'libarclite'的解决方案

问题描述

升级至Xcode 15后，在构建React Native应用时出现以下错误：

clang

clang: error: SDK does not contain 'libarclite' at the path '/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/arc/libarclite_iphoneos.a'; try increasing the minimum deployment target

该问题通常发生在部署目标（Deployment Target）低于 iOS 11 的情况下。错误提示虽然建议提高部署目标，但即使用户已设置最低目标为 iOS 13.0（如Podfile中所示），仍可能发生此错误。

关键线索

根据Apple官方人员确认：

libarclite用于支持旧版iOS（iOS 11之前）的ARC（自动引用计数）。若项目中存在低于iOS 11的部署目标设置，会触发此错误。不应通过修改Xcode安装来解决，而需统一部署目标。

根本原因

项目中使用的某些CocoaPods依赖库单独设置了低于iOS 11的部署目标（如iOS 9或10），与主项目设置的iOS 13.0目标冲突，导致Xcode工具链无法找到已废弃的libarclite库。

解决方案

方法1：修改Podfile添加自动化配置（推荐）

在Podfile末尾添加post_install钩子脚本，强制统一所有Pod的部署目标：

ruby

post_install do |installer|
  react_native_post_install(installer)
  $RNMBGL.post_install(installer)
  __apply_Xcode_12_5_M1_post_install_workaround(installer)
  # 删除旧版设置 __apply_Xcode_14_3_RC_post_install_workaround(installer)
  
  # [!] 新增：统一所有Pod的部署目标
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings["IPHONEOS_DEPLOYMENT_TARGET"] = "13.0" # 与项目目标一致
    end
  end
end

操作步骤

打开Podfile文件
找到现有的post_install代码块
删除__apply_Xcode_14_3_RC_post_install_workaround相关调用和定义
添加上述代码块中的循环设置段
终端执行：

bash

rm -rf ios/Pods
pod install --repo-update

方法2：手动修改Xcode中的Pod目标（临时方案）

在Xcode项目中打开Pods子工程
左侧导航栏选择所有Pods目标（按住Cmd多选）
在右侧Build Settings中搜索iOS Deployment Target
将所有Pod的部署目标统一设为iOS 13.0（或更高）
重新编译项目

方法3：删除Pod的独立部署设置（备选）

在post_install中删除所有Pod的IPHONEOS_DEPLOYMENT_TARGET设置，使其继承项目主配置：

ruby

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings.delete 'IPHONEOS_DEPLOYMENT_TARGET'
    end
  end
end

注意事项

该方法可能导致部分老旧Pod无法正确适配高版本iOS，若出现兼容性问题请回退到方法1

解决方案选择建议

方案	适用场景	维护成本
修改Podfile	长期项目/团队协作	⭐️⭐️⭐️⭐️ (自动同步配置)
手动修改Xcode	快速验证/临时修复	⭐️ (每次pod install后需重设)
删除独立配置	简单项目/Pod版本较新	⭐️⭐️⭐️ (可能需处理兼容性)

原理说明

当项目中存在低于iOS 11的部署目标时，Xcode 15会尝试加载已从SDK中移除的libarclite库（旧版ARC兼容层）。统一所有Pod的部署目标至iOS 11+即可避免该问题。

总结

解决此问题的核心是统一项目中的所有iOS部署目标不低于iOS 11。推荐通过修改Podfile添加自动化脚本（方案1），保证每次执行pod install后配置的一致性。升级后如遇其他Pod兼容性问题，可逐步检查并更新老旧依赖库。

最终效果验证：重建项目后clang: error: SDK does not contain 'libarclite'错误应完全消失，应用正常编译运行。

相关文章

Xcode 15构建错误：SDK不包含'libarclite'的解决方案 ​

问题描述 ​

根本原因 ​

解决方案 ​

方法1：修改Podfile添加自动化配置（推荐） ​

方法2：手动修改Xcode中的Pod目标（临时方案） ​

方法3：删除Pod的独立部署设置（备选） ​

解决方案选择建议 ​

原理说明 ​

总结 ​