如何手动集成Swift静态库至OC/Swift项目（非子项目）及添加Swift .a与-Swift.h

我来一步步帮你梳理清楚这两个问题的解决办法，都是实战中验证过的步骤：

一、不通过子项目，手动集成Swift静态库到项目 #

针对Objective-C项目 #

• 先准备好所有必需文件：编译好的Swift静态库.a文件、自动生成的[你的库模块名]-Swift.h头文件（这是Swift代码暴露给OC的核心接口文件），以及库的其他公共头文件（如果有的话）。
• 把.a文件直接拖到你的OC项目里，记得勾选「Copy items if needed」，确保文件被复制到项目本地目录，避免路径问题。
• 配置Build Settings：
  • 找到Other Linker Flags，添加-ObjC和-lc++（Swift底层依赖C++标准库，不加这个会报链接错误）。
  • 找到Header Search Paths，添加[你的库模块名]-Swift.h和其他公共头文件所在的目录路径，推荐用$(SRCROOT)开头的相对路径，比如$(SRCROOT)/ThirdParty/MySwiftLib，这样换环境也不会出问题。
  • 如果你的OC项目里原本没有Swift代码，先随便加个空的Swift文件（比如Temp.swift），Xcode会自动生成Swift编译相关的配置，之后删掉这个空文件也没关系，配置会保留。找到Swift Compiler - General下的Objective-C Generated Interface Header Name，确认配置存在即可。
• 在需要调用Swift库的OC文件里，导入头文件：#import "你的库模块名-Swift.h"，比如你的库叫NetworkLib，就是#import "NetworkLib-Swift.h"。
• 最后编译测试，如果报架构不匹配的错误，用lipo -info 你的库文件.a命令查看库的支持架构，确保和你的项目目标架构（比如arm64、x86_64）一致。

针对Swift项目 #

• 同样先准备好.a文件、库的公共头文件（包括[你的库模块名]-Swift.h，不过Swift项目更推荐用模块导入）。
• 把.a文件拖入Swift项目，勾选「Copy items if needed」。
• 配置Build Settings：
  • 找到Other Linker Flags，添加-ObjC和-lc++。
  • 找到Library Search Paths，添加.a文件所在的目录路径；再找到Import Paths，添加库的公共头文件目录。
  • 如果你的Swift库有.modulemap模块映射文件，把它也添加到项目里，然后在Build Settings的Module Map File里指定它的路径；如果没有，直接在Swift文件里用import 你的库模块名导入即可。
• 编译测试，确认没有链接错误，架构匹配。

二、添加Swift .a文件及其关联的-Swift.h头文件的关键细节 #

这部分是上面集成步骤的核心拆解，重点注意这些点：

• 获取[你的库模块名]-Swift.h：这个文件是Xcode编译Swift静态库时自动生成的，默认在DerivedData目录里。你可以在Swift库项目的Build Settings中找到Objective-C Generated Interface Header Name，确认文件名，然后从编译后的产物目录里把它复制出来，和.a文件放在同一目录下。
• 添加.a文件后，去项目的Build Phases -> Link Binary With Libraries里确认.a文件已经被添加进去，如果没自动加上，手动点击+把它加进去。
• 头文件路径配置：在Header Search Paths里添加[你的库模块名]-Swift.h所在的目录，根据你的文件结构选择recursive（递归查找）或者non-recursive（非递归）。
• 注意：[你的库模块名]-Swift.h里只包含用@objc或@objcMembers修饰的Swift类、方法和属性。如果你的Swift库有需要暴露给OC的接口，一定要在代码里加上这些修饰符，否则OC里看不到。
• 如果OC项目里导入头文件时提示找不到，试试把Build Settings里的Allow Non-modular Includes in Framework Modules设置为YES，或者直接用绝对路径导入头文件。

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