如何在Objective-C iOS项目中调用Swift框架（Starscream）？

一、解决Starscream-Swift.h文件找不到的问题 #

不需要手动复制头文件，Xcode会自动生成该文件，问题通常出在框架配置或导入方式上，按以下步骤排查：

1. 检查Swift框架的关键配置

   • 打开Starscream框架的项目，进入Build Settings，找到Defines Module选项，确保设置为YES。只有开启这个选项，Xcode才会生成模块结构和对应的Swift头文件。
   • 确认Product Module Name设置为Starscream，保证和你导入时使用的模块名一致。

2. 使用正确的导入语法
   在Objective-C的.m文件中，必须使用模块导入语法：

   #import <Starscream/Starscream-Swift.h>
   

   不要用双引号的本地文件导入方式，因为这是框架模块的头文件，需要通过模块路径访问。

3. 清理并重新构建项目

   • 按下Command+Shift+K清理当前构建文件夹
   • 按下Command+Option+Shift+K彻底清理所有缓存文件
   • 重新构建项目，让Xcode重新生成框架的头文件和模块信息

4. 验证框架引用配置

   • 确认Starscream框架已正确添加到Objective-C项目的Frameworks, Libraries and Embedded Content列表，且设置为Embed & Sign
   • 检查项目Build Settings中的Framework Search Paths，确保包含Starscream框架所在的路径（可以设置为相对路径，比如$(PROJECT_DIR)/Frameworks，根据你的框架存放位置调整）

二、Objective-C项目使用Swift库的注意事项 #

• Swift API的可访问性：只有标记了@objc或继承自NSObject的Swift类、方法、属性才能在Objective-C中被访问。Starscream的公开API已经做了适配，但如果自己扩展该库，需要手动添加@objc标记。
• 部署目标兼容性：Swift框架的部署目标不能高于Objective-C项目的部署目标，否则会出现编译或运行时兼容性问题。
• 优先使用包管理工具：相比手动拖拽框架，使用CocoaPods或Swift Package Manager集成Starscream更可靠，这类工具会自动处理模块配置、头文件路径、依赖管理等问题，减少手动配置出错的概率。
• 避免头文件循环引用：不要在Objective-C的.h文件中导入Starscream-Swift.h，只在.m文件中导入即可。如果需要在头文件中声明Swift类的指针，可以使用@class WebSocket;（以Starscream的WebSocket类为例）。
• 类型映射注意事项：Swift和Objective-C的类型存在映射关系，比如Swift的Optional对应Objective-C的nullable/nonnull，Swift的String对应Objective-C的NSString，调用API时要注意类型匹配，避免类型转换错误。

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