如何为依赖Objective-C静态库的Swift框架声明Podspec

嘿，针对你开发的Swift静态框架MyFramework依赖Objective-C第三方库NewRelicAgent的场景，我来帮你把Podspec配置补全并修正到位，完美适配CocoaPods 1.4.0的特性：

完整的Podspec关键配置片段 #

Pod::Spec.new do |s|
  s.name             = 'MyFramework'
  s.version          = '0.1.0'
  s.summary          = '你的Swift框架功能简介'
  s.homepage         = '你的框架主页地址'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { '你的名字' => '你的联系邮箱' }
  s.source           = { :git => '你的Git仓库地址', :tag => s.version.to_s }

  # 保留你已有的源文件配置
  s.source_files = 'MyFrame/Classes/**/*'
  
  # 必须声明为静态框架（你已经设置了，这是核心前提）
  s.static_framework = true

  # 依赖NewRelicAgent，版本匹配你指定的6.1.1
  s.dependency 'NewRelicAgent', '6.1.1'

  # 核心配置：处理Swift与Objective-C交互、路径与链接
  s.xcconfig = {
    # 简化头文件搜索路径，确保能找到NewRelic的Objective-C头文件
    'HEADER_SEARCH_PATHS' => '$(PODS_ROOT)/NewRelicAgent/NewRelicAgent.framework/Headers',
    # 指定Swift桥接文件路径（如果你的框架需要在Swift中调用NewRelic API）
    'SWIFT_OBJC_BRIDGING_HEADER' => '$(PODS_TARGET_SRCROOT)/MyFrame/Classes/MyFramework-Bridging-Header.h',
    # 链接必需的标记：-ObjC确保Objective-C类别被正确加载，-lNewRelicAgent指定链接静态库
    'OTHER_LDFLAGS' => '-ObjC -lNewRelicAgent',
    # 让Xcode能找到NewRelic的框架文件
    'FRAMEWORK_SEARCH_PATHS' => '$(PODS_ROOT)/NewRelicAgent'
  }

  # NewRelic依赖的系统框架必须显式声明，否则会出现链接错误
  s.frameworks = 'SystemConfiguration', 'CoreTelephony', 'Security', 'Foundation', 'UIKit'

  # 可选：如果需要暴露框架的公共头文件给使用者，取消注释下面一行
  # s.public_header_files = 'MyFrame/Classes/Public/**/*.h'

  # 指定框架支持的最低iOS版本（根据你的需求调整）
  s.ios.deployment_target = '10.0'
end

关键配置细节解释 #

• s.static_framework = true：这是刚需，因为你开发的是静态框架，同时依赖的NewRelic也是静态库，CocoaPods 1.4.0需要显式声明这一点才能正确处理依赖链路。
• 依赖声明：s.dependency 'NewRelicAgent', '6.1.1' 完全正确，CocoaPods会自动拉取对应版本的库并处理路径，你之前的HEADER_SEARCH_PATHS路径可以简化，不需要写得那么冗长。
• XCConfig核心配置：
  • SWIFT_OBJC_BRIDGING_HEADER：如果你的Swift代码要调用NewRelic的API，必须创建桥接文件并在其中引入#import <NewRelicAgent/NewRelicAgent.h>，这里要确保路径指向你实际的桥接文件。
  • OTHER_LDFLAGS里的-ObjC是重中之重，Objective-C静态库的类别（Category）只有加上这个标记才能被正确链接，否则会出现运行时找不到方法的错误。
• 系统框架依赖：NewRelicAgent底层依赖几个iOS系统框架，必须显式声明，不然编译时会出现缺失符号的链接错误。

额外验证与注意事项 #

1. 桥接文件检查：如果还没创建桥接文件，赶紧在框架的Classes目录下新建一个（比如MyFramework-Bridging-Header.h），并添加NewRelic的头文件引入。
2. 验证Podspec：配置完成后，用命令pod lib lint MyFramework.podspec --verbose检查是否有错误，根据终端提示调整细节。
3. CocoaPods版本兼容：你用的1.4.0版本完全支持这些配置，如果后续遇到奇怪的问题，可以考虑升级到1.11.x这类稳定版本，但当前配置无需改动。

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