在Objective-C项目中通过CocoaPods引入GTMAppAuth报文件找不到错误

以下是排查和解决该问题的具体步骤：

• 确认项目打开方式
  务必通过项目对应的xxx.xcworkspace文件打开工程，而非xxx.xcodeproj。使用CocoaPods管理依赖后，Xcode只有通过workspace才能正确识别Pods的头文件路径。

• 重新安装Pods依赖
  执行以下命令彻底清理并重新安装Pods：

  pod deintegrate
  pod install
  

  避免因缓存或不完整安装导致的路径配置异常。

• 检查头文件搜索路径配置
  进入项目Target的Build Settings面板，找到Header Search Paths选项，确认其中包含$(inherited)和${PODS_ROOT}/GTMAppAuth/Source路径，且设置为recursive（递归搜索）。若缺失，手动添加并保存配置。

• 调整导入语法
  由于启用了use_frameworks!，可尝试两种导入方式：
  框架式导入（推荐）：

  #import <GTMAppAuth/GTMAppAuth.h>
  

  或相对路径导入：

  #import "GTMAppAuthFetcherAuthorization.h"
  

• 清理项目缓存
  执行Xcode菜单的Product > Clean Build Folder（快捷键Cmd+Shift+K），随后重启Xcode并重新编译项目，清除可能存在的编译缓存问题。

• 验证版本兼容性
  检查GTMAppAuth版本是否适配iOS 12.0。可在Podfile中指定兼容版本，例如：

  pod 'GTMAppAuth', '~> 1.0.0'
  

  再重新执行pod install安装指定版本。

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