如何编写含依赖Pod的Podspec？Mac框架打包遇构建错误

看起来你遇到的核心问题是Podspec里的路径配置不对，以及没有正确让CocoaPods管理OpenSSL的依赖，导致lint时找不到头文件和库。我来一步步帮你修正：

1. 核心思路梳理 #

要让调用方无需额外安装OpenSSL-Universal，最稳妥的方式是在你的Podspec中声明对它的依赖，让CocoaPods自动帮你拉取和管理这个库，这种方式比手动复制文件更简洁易维护。

2. 修正后的完整Podspec配置 #

下面是调整后的Podspec示例，我会逐个解释关键改动点：

Pod::Spec.new do |s|
  s.name         = "SwiftHttp2"
  s.version      = "0.0.1"
  s.summary      = "你的框架简介"
  s.homepage     = "你的项目主页"
  s.license      = { :type => "MIT", :file => "LICENSE" }
  s.author       = { "你的名字" => "你的邮箱" }
  s.platform     = :osx, "10.10" # 根据你的最低支持版本调整
  s.source       = { :git => "你的Git仓库地址", :tag => "#{s.version}" }

  # 保留原有正确的源文件配置
  s.source_files = "**/*.{h,swift}"
  s.exclude_files = "Classes/Exclude"

  # 关键：声明OpenSSL-Universal为依赖，CocoaPods会自动安装它
  s.dependency "OpenSSL-Universal"

  # 保留你的modulemap文件
  s.preserve_paths = "SwiftSSL/module.modulemap"

  # 修正xcconfig路径，用$(PODS_ROOT)定位OpenSSL的文件（这是之前出错的核心）
  s.xcconfig = {
    # 让Swift找到你的modulemap目录
    "SWIFT_INCLUDE_PATHS" => "$(SRCROOT)/#{s.name}/SwiftSSL",
    # 头文件搜索路径指向OpenSSL的macOS平台公共头目录
    "HEADER_SEARCH_PATHS" => "$(PODS_ROOT)/OpenSSL-Universal/include-macos",
    # 库搜索路径指向OpenSSL的macOS静态库目录
    "LIBRARY_SEARCH_PATHS" => "$(PODS_ROOT)/OpenSSL-Universal/lib-macos"
  }

  # 显式指定要链接的OpenSSL静态库，避免链接错误
  s.libraries = "crypto", "ssl"
end

3. 调整module.modulemap文件 #

原来的相对路径在Pod环境下会失效，因为HEADER_SEARCH_PATHS已经包含了OpenSSL的头目录，所以简化成这样：

module SwiftSSL {
    header "openssl/ssl.h"
    header "openssl/crypto.h"
    export *
}

4. 运行lint的正确命令 #

因为OpenSSL是静态库，lint时需要加上--use-libraries参数：

pod spec lint SwiftHttp2.podspec --use-libraries --verbose

之前报错的原因解析 #

• 你用了$(SRCROOT)/Pods，但在pod lint的测试环境中，SRCROOT是测试项目的根目录，而你的Pod和OpenSSL都在$(PODS_ROOT)下，路径完全不匹配。
• 头文件搜索路径没指向正确的OpenSSL include目录，导致找不到opensslconf.h。
• 库搜索路径里的lib-macros是笔误，OpenSSL-Universal针对macOS的库目录是lib-macos。

这样调整后，你的Pod就能正确集成OpenSSL-Universal，调用方只需要引入你的Pod，不需要额外处理OpenSSL的安装。

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