集成IDNow SDK时Xcode报FLAnimatedImage.h文件找不到的问题求助

环境配置 #

• 搭载M1芯片的MacBook
• Xcode 13.3.1
• iOS 15.4
• IDNow SDK v5.1.6
• 已安装Pods：AFNetworking、FLAnimatedImage、SocketRocket、Masonry、libPhoneNumber-iOS

问题概述 #

项目中FLAnimatedImage框架已存在于Pods目录，但编译时抛出FLAnimatedImage.h file not found错误，已尝试清理构建文件夹、权限配置、Build Phase导入、排除armv64架构等常规方案均无效。

针对性解决方案 #

1. 重置Pod集成环境 #

• 删除项目根目录下的Pods文件夹、Podfile.lock文件
• 执行终端命令：pod deintegrate
• 重新执行：pod install
• 注意：必须打开生成的.xcworkspace文件，而非原生.xcodeproj

2. 修正头文件搜索路径 #

• 打开项目Target的Build Settings，搜索Header Search Paths
• 确保路径中包含$(inherited)（继承Pod自动配置的路径）
• 添加自定义路径：${PODS_ROOT}/FLAnimatedImage/FLAnimatedImage，并设置为recursive（递归搜索）

3. 验证框架嵌入配置 #

• 进入Target的Frameworks, Libraries, and Embedded Content面板
• 检查FLAnimatedImage.framework是否已添加，若未添加则手动从Pods/FLAnimatedImage目录导入
• 将框架的嵌入状态设置为Embed & Sign

4. 统一架构排除配置 #

在Podfile末尾添加以下代码，确保Pod与项目的架构设置一致：

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

添加后重新执行pod install。

5. 彻底清除Xcode缓存 #

• 执行终端命令：rm -rf ~/Library/Developer/Xcode/DerivedData
• 重启Xcode，清理构建文件夹（Cmd+Shift+K）后重新编译

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