如何在Podspec依赖中正确配置:modular_headers参数？

问题详情 #

我的Podspec依赖配置如下：

s.dependency "React-Core"
s.dependency "AWSCore", '2.9.8'
s.dependency "AWSLogs", '2.9.8'
s.dependency "BCryptSwift", '1.1'
s.dependency "CryptoSwift", '1.0'
s.dependency "JWTDecode", '2.6'
s.dependency "MQTTClient", '0.15.2'
s.dependency "MQTTClient/Websocket", '0.15.2'
s.dependency "ObjcExceptionBridging", '1.0.1'
s.dependency "OpenSSL-Universal", '1.1.1100'
s.dependency "ReachabilitySwift", '5.0.0'
s.dependency "SocketRocket", '0.5.1'
s.dependency "SwiftSocket", '2.0.2'
s.dependency "XCGLogger", '7.0.0'

构建时触发静态库集成错误：

[!] The following Swift pods cannot yet be integrated as static libraries:

The Swift pod `XCGLogger` depends upon `ObjcExceptionBridging`, which does not define modules. To opt into those targets generating module maps (which is necessary to import them from Swift when building as static libraries), you may set `use_modular_headers!` globally in your Podfile, or specify `:modular_headers => true` for particular dependencies.

The Swift pod `openpath-reactnative` depends upon `AWSCore`, `AWSLogs`, `MQTTClient`, and `SocketRocket`, which do not define modules. To opt into those targets generating module maps (which is necessary to import them from Swift when building as static libraries), you may set `use_modular_headers!` globally in your Podfile, or specify `:modular_headers => true` for particular dependencies.

尝试在Podspec的依赖中添加:modular_headers => true参数（如s.dependency "ObjcExceptionBridging", '1.0.1', :modular_headers => true），却收到报错：

Invalid `openpath-reactnative.podspec` file: [!] Unsupported version requirements. ["1.0.1", {:modular_headers=>true}] is not valid..

解决方法 #

1. 核心说明：Podspec不支持直接给依赖传:modular_headers参数 #

CocoaPods的Podspec语法中，s.dependency仅接受版本号或版本约束，不支持传递:modular_headers这类配置选项，这是触发报错的核心原因。该参数只能在Podfile中配置，或通过Podspec的其他方式间接处理。

2. 优先方案：在Podfile中配置模块化头文件 #

方案A：全局启用模块化头文件

如果项目所有依赖都兼容模块化头文件，在Podfile开头添加：

use_modular_headers!

此配置会让所有Objective-C依赖自动生成模块映射，Swift代码可正常导入。

方案B：为特定依赖单独启用

若不想全局启用，仅针对报错中提到的依赖配置：

pod 'AWSCore', '2.9.8', :modular_headers => true
pod 'AWSLogs', '2.9.8', :modular_headers => true
pod 'MQTTClient', '0.15.2', :modular_headers => true
pod 'MQTTClient/Websocket', '0.15.2', :modular_headers => true
pod 'ObjcExceptionBridging', '1.0.1', :modular_headers => true
pod 'SocketRocket', '0.5.1', :modular_headers => true

注意保持版本号与Podspec中的配置一致。

3. 备选方案：在Podspec中通过XC配置强制启用模块 #

如果必须在Podspec层面处理，可给你的库添加XC配置，强制开启模块支持：

s.pod_target_xcconfig = {
  'CLANG_ENABLE_MODULES' => 'YES'
}

此方法优先级低于Podfile配置，仅作为前两种方案不可用时的备选。

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