tvOS编译报错：未找到对应平台库，集成第三方库后出现该问题

常见排查与解决步骤 #

• 确认第三方库支持tvOS平台
  不少第三方库仅适配iOS/macOS，不兼容tvOS。直接查看库的官方文档、GitHub仓库README，或是其.podspec文件（若用CocoaPods集成）里的platforms字段，确认是否包含tvOS。
• 检查集成方式正确性
  • 若用CocoaPods：确保Podfile指定了tvOS平台，示例代码如下：

    platform :tvos, '15.0'
    target 'YourTVOSApp' do
      use_frameworks!
      pod 'YourLibrary'
    end
    

    执行pod install --repo-update重新拉取依赖，确保安装的是适配tvOS的库版本。
  • 若手动导入库：检查.framework或.xcframework文件是否包含tvOS架构（如arm64-apple-tvos、x86_64-apple-tvos-simulator），可通过终端命令lipo -info 库文件路径查看支持的架构列表。
• 验证Xcode项目配置
  • 选中项目Target，进入Build Phases -> Link Binary With Libraries，确认导入的是tvOS版本的库，而非iOS版本。
  • 检查Build Settings里的Valid Architectures和Supported Platforms，确保仅勾选tvOS相关选项，无iOS平台设置混入。
• 清理项目后重新编译
  执行Xcode菜单Product -> Clean Build Folder（快捷键Shift+Command+K），再删除Derived Data（路径可在Xcode -> Settings -> Locations中找到），之后重新编译项目。

针对报错截图的补充提示 #

从报错截图指向的具体库文件来看，优先确认该库是否真的提供tvOS适配版本。若库本身不支持tvOS，可考虑更换替代库，或是基于开源库自行修改代码适配tvOS（仅适用于开源库）。

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