如何在CocoaPods框架中声明由集成者定义的extern变量？

核心问题出在CocoaPods框架的编译链接机制和纯静态库不同：纯静态库只负责编译打包，最终链接由主项目完成；而动态框架编译时必须解析所有符号，导致未定义的extern变量触发链接错误。下面分两种框架类型给出解决方案：

方案1：使用静态框架（推荐，和原纯静态库逻辑一致） #

静态框架的符号解析会延迟到主项目链接阶段，完全适配你原来的需求：

• 在Pod的公共头文件（比如YourPod.h）中声明extern变量：

  extern NSString *const YourCustomConstant;
  

• 在Pod的podspec文件中启用静态框架配置：

  s.static_framework = true
  

  或者在集成方的Podfile中指定静态链接：

  use_frameworks! :linkage => :static
  

• 绝对不要在Pod的任何.m/.swift文件中定义这个变量，完全交给集成者在自己的项目中定义（比如在主项目的某个.m文件中添加：NSString *const YourCustomConstant = @"UserDefinedValue";）

这样Pod编译时只会生成静态库文件，不会检查符号定义，主项目链接时会自动将自己的变量定义和Pod代码结合，不会出现链接错误。

方案2：使用动态框架（弱符号兼容） #

如果必须用动态框架，需要通过弱符号机制让框架编译时允许符号未定义，运行时优先使用主项目的定义：

• 在Pod的公共头文件中声明extern变量：

  extern NSString *const YourCustomConstant;
  

• 在Pod的某个.m文件中添加弱符号的默认定义（可选，避免集成者未定义时崩溃）：

  __attribute__((weak)) NSString *const YourCustomConstant = @"DefaultFallbackValue";
  

• 集成者在主项目中定义同名变量时，会自动覆盖框架中的弱定义，运行时使用主项目的值。

补充：Swift项目集成的处理 #

如果集成者用Swift项目，需要用@_cdecl暴露符合C规范的变量：

@_cdecl("YourCustomConstant") let YourCustomConstant = "SwiftUserValue"

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