将基于OpenSSL的加密代码迁移到Swift Framework遇头文件缺失问题

1. 确认OpenSSL Pod的依赖配置 #

先确保Podfile里引入了靠谱的OpenSSL Pod（比如pod 'OpenSSL-Universal'），并且已经执行过pod install。然后去Xcode的Pods项目下，检查你的Framework target是否被勾选了OpenSSL的依赖——不少人会漏掉这一步导致头文件找不到。

2. 调整模块映射文件（module.modulemap） #

别直接在伞头文件里引入<openssl/ec.h>，通过模块映射来处理OpenSSL的模块引用。在你的Framework目录下创建module.modulemap，内容可以这么写：

module YourFrameworkName {
    umbrella header "YourFrameworkUmbrellaHeader.h"
    
    export *
    module * { export * }

    // 直接引入需要的OpenSSL头文件，路径用Pods变量更灵活
    module OpenSSL {
        header "$(PODS_ROOT)/OpenSSL-Universal/include/openssl/ec.h"
        header "$(PODS_ROOT)/OpenSSL-Universal/include/openssl/evp.h"
        // 其他你用到的OpenSSL头文件都可以加在这里
        export *
    }
}

如果OpenSSL本身自带模块映射，也可以直接用@import OpenSSL;替代上面的模块定义，写法更简洁。

3. 修正伞头文件内容 #

伞头文件里只需要引入你自己编写的加密工具类头文件，比如：

#import "YourCustomEncryptionUtils.h"

你自己的YourCustomEncryptionUtils.h里可以正常引入<openssl/ec.h>，模块映射已经帮你解决了路径问题。

4. 调整Framework的Build Settings #

• 找到Header Search Paths，添加$(PODS_ROOT)/OpenSSL-Universal/include，并勾选recursive选项。
• 在Module Map File中指定你的module.modulemap路径，比如$(SRCROOT)/YourFramework/module.modulemap。
• 确保Defines Module设置为YES，且Module Name和你的Framework名称完全一致。

5. 检查编译顺序 #

进入Framework target的Build Phases，确认Pods-YourFrameworkName脚本在Compile Sources之前执行，保证OpenSSL的头文件在编译你的代码前就已加载完成。

6. 清理缓存后重建 #

按下Cmd+Shift+K清理Build Folder，再重新构建项目——很多奇怪的编译报错都是缓存导致的。

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