iOS安装Kingfisher库失败求助：附错误截图与Pod文件

排查步骤 #

• 检查项目最低支持系统版本：Kingfisher 7.x版本要求最低适配iOS 12、macOS 10.14、tvOS 12、watchOS 5，若你的项目目标系统版本低于上述要求，需要指定安装Kingfisher 6.x版本，最高兼容到iOS 10。
• 检查CocoaPods本地索引是否最新：索引过期会导致无法拉取到最新版本的库，执行pod repo update更新本地索引即可。
• 清理残留的无效安装文件：之前的安装失败残留文件会导致重复报错，依次执行以下命令清理：

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

正确安装步骤 #

1. 打开项目根目录下的Podfile，在对应target的依赖块中添加Kingfisher依赖配置：
   • 项目适配iOS 12及以上：
     pod 'Kingfisher', '~> 7.0'
   • 项目需要适配iOS 10/11：
     pod 'Kingfisher', '~> 6.3.1'
2. 保存Podfile后，在终端进入项目根目录，执行pod install命令完成安装。
3. 安装完成后必须关闭原有的.xcodeproj文件，使用生成的.xcworkspace文件打开项目，才能正常引入Kingfisher库使用。

常见报错解决 #

• Swift版本不匹配报错：在Podfile末尾添加以下配置，统一所有Pods的Swift版本即可：

  post_install do |installer|
    installer.pods_project.targets.each do |target|
      target.build_configurations.each do |config|
        config.build_settings['SWIFT_VERSION'] = '5.0'
      end
    end
  end
  

• 架构不兼容报错：打开项目Build Settings，检查Excluded Architectures配置，确保和Pods项目的架构配置保持一致，模拟器运行时不要排除arm64架构。
• 头文件找不到报错：确认Build Settings中的Other Linker Flags配置里已经添加了$(inherited)参数。

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