Xcode 9.2框架模块引入非模块化头文件报错求助

我之前在Xcode 9.2里给Swift框架集成Google Analytics时也碰到过一模一样的问题，这个错误本质是因为Google Analytics的头文件属于非模块化头文件，而框架的伞形头文件对导入的内容有严格的模块校验规则。下面是几个可行的解决方案，按推荐优先级排序：

方案1：使用桥接头文件（最推荐） #

框架里的第三方依赖不应该直接暴露在伞形头里，更合理的做法是通过桥接头文件让Swift代码能访问Google Analytics的API：

• 给你的框架创建一个桥接头文件，比如命名为YourFrameworkName-Bridging-Header.h
• 在这个桥接头文件里添加导入语句：

  #import <Google/Analytics.h>
  

• 打开框架target的Build Settings，找到Objective-C Bridging Header选项，填入桥接头文件的相对路径（比如YourFramework/YourFrameworkName-Bridging-Header.h）
• 之后你就可以在Swift框架的任意类里直接使用Google Analytics的API了，不需要在伞形头里做任何导入。

方案2：修改Build Settings允许非模块化导入（不推荐但应急可用） #

如果你确实需要在伞形头里导入Google Analytics的头文件，可以临时关闭Xcode的模块校验：

• 选中框架target，进入Build Settings
• 搜索Allow Non-modular Includes In Framework Modules，把它的值设置为YES
• 回到伞形头文件，重新导入<Google/Analytics.h>，错误应该会消失

⚠️ 注意：这个设置会降低框架的模块兼容性，可能给框架的使用者带来潜在问题，所以除非必要，优先用方案1。

额外检查项 #

• 确认你的Podfile正确配置了Google Analytics的依赖，并且已经执行过pod install：

  target 'YourFrameworkName' do
    use_frameworks!
    pod 'GoogleAnalytics'
  end
  

• 检查框架target的Defines Module选项是否设置为YES（默认开启，这是框架能正常作为模块的基础）

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