Cocoapods subspec依赖未自动添加头/库搜索路径如何解决？

问题根源 #

• 你使用的CocoaPods 1.10.1对预编译XCFramework的子spec传递依赖处理存在缺陷，Firebase 7.x系列的Analytics组件已经采用预编译XCFramework的形式分发，主工程Podfile直接引入时CocoaPods会直接把XCFramework配置加到主工程的构建设置里，但作为subspec的依赖时，旧版本CocoaPods不会自动把依赖的XCFramework的搜索路径、链接参数传递到你的subspec的目标构建设置中，因此会报找不到框架的错误。
• Firebase/CoreOnly的头文件路径没有被自动加入到你的subspec的头搜索路径，也是旧版本CocoaPods处理静态库/XCFramework依赖的常见问题。

无需手动添加xcconfig的解决方案 #

方案1：升级CocoaPods到1.11.0及以上版本 #

CocoaPods 1.11.0修复了大量XCFramework传递依赖的处理问题，支持自动继承依赖的框架搜索路径、链接参数，你只需要更新本地CocoaPods版本，就可以删掉所有手动添加的xcconfig配置，subspec可以正常构建和通过lint校验。
升级命令：

sudo gem install cocoapods

升级后执行lint时可加上--allow-warnings参数，避免Firebase本身的警告导致校验不通过。

方案2：如果必须保留CocoaPods 1.10.1版本，可修改依赖声明 #

你可以在subspec里额外显式添加Firebase依赖的底层组件依赖，不需要手动修改xcconfig：

s.subspec 'FirebaseAnalytics' do |a|
  a.source_files = ['Sources/PromotedFirebaseAnalytics/**/*.{h,m,swift}']
  a.dependency 'Firebase/Core', '~> 7.11.0'
  a.dependency 'Firebase/Analytics', '~> 7.11.0'
  a.dependency 'GoogleUtilities'
  a.dependency 'nanopb'
  a.dependency 'PromotedAIMetricsSDK/Core'
end

显式声明这几个底层依赖后，CocoaPods会自动把这些组件的构建设置传递到你的subspec目标上，不需要手动编写xcconfig。

补充验证点 #

• 检查你的subspec对应的代码目录里的Firebase导入语句有没有拼写错误，也不要使用引号导入的错误写法，正确的导入方式为@import FirebaseAnalytics;（OC）或者import FirebaseAnalytics（Swift）。
• 执行lint时可以加上--verbose参数，查看具体的构建日志，确认依赖的XCFramework有没有被正确加入到构建流程里。

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