我在将一个项目从swift2更新到swift3后遇到了这个问题。我使用XCode 8.3.2更新代码，无法摆脱“框架模块内的非模块化头”的错误。当我在另一个版本的XCode(版本9.0.1)中打开相同的项目时，错误没有出现。

这是编译器预期的行为，有很好的理由。

I think the majority of people running into this issues is caused after they switch from Application Target to Framework Target and start adding C and Objective C headers into framework's umbrella header expecting it to have a same behaviour as application's Bridging Header, which behaves differently. The umbrella header is actually designated for mixed swift, obj-c framework and its purpose is exposing the APIs to the outer world that your framework has in objective-c or c. That means the headers we put there should be in the public scope.

它不应该被用作将不属于框架的Objective-C/C头文件暴露给框架swift代码的地方。因为在这种情况下，这些头文件也将作为框架模块的一部分对外公开，这通常不是我们想要做的，因为它破坏了模块化。(这就是为什么允许非模块化包含在框架模块默认为NO)

为了将Objective-C/C库公开给你的框架swift代码，我们应该为这个库定义一个单独的swift模块。然后可以使用标准的快速导入YourLegacyLibrary。

让我在一些典型场景中演示这一点:将libxml2嵌入到我们的框架中。

1. 首先需要创建一个模块。Modulemap文件，如下所示:

对于OSX框架:

module SwiftLibXML2 [system] {
  header "/usr/include/libxml2/libxml/xpath.h"
  export *
}

对于iOS框架:

module SwiftLibXML2 [system] {
  header "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/usr/include/libxml2/libxml/xpath.h"
  export *
}

它所做的只是将头文件和它在swift模块中引用的其他头文件打包起来，这样swift就能够为这些C接口生成swift绑定。

2. 然后在你的xcode项目目录中创建一个文件夹SwiftLibXML2，并把这个模块。modulemap那里

3.在构建设置中，将$(SDKROOT)/usr/include/libxml2添加到头搜索路径中

4. 在Build Settings中，将$(SRCROOT)/SwiftLibXML2添加到Import Paths中

5. 在Project的General选项卡下，添加libxml2。tbd到链接的框架和库。

现在你可以在需要的地方导入这个模块:

import SwiftLibXML2

(如果你想看一个更完整的模块。地图的例子，我建议参考达尔文的模块。模块映射在/usr/include/module。modulemap，你需要安装Xcode命令行工具才能到达那里，参考OS X El Capitan中缺少/usr/include)

迅速:

1. 修改你的Xcode项目和目标的构建设置如下所示:

允许非模块包含在框架模块中

Enable Bitcode:是

2. 使用当前最新版本的GoogleMaps iOS SDK(使用CocoaPods获取):

谷歌地图 （1.10.4）

3.注释有问题的导入:

//import GoogleMaps

4. 创建或修改桥接头文件，添加有问题的导入:

[你的Xcode项目名称]-Bridging-Header.h

// Use this file to import your target's public headers 
// that you would like to expose to Swift.
#import <GoogleMaps/GoogleMaps.h>

5. 清理并重新构建Xcode项目。

下面是如何自动应用快速修复，这样你就不必更换Pods了。在每个pod安装后手动Xcodeproj。

将这个片段添加到Podfile的末尾:

post_install do |installer|
  installer.pods_project.build_configuration_list.build_configurations.each do |configuration|
    configuration.build_settings['CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES'] = 'YES'
  end
end

这个答案已经过时了。

导入框架时，必须导入所有与根头文件共享依赖关系的头文件。确保这总是有效的最简单的方法是导入框架的“headers”文件夹中的所有头文件到你的公共头文件路径。

Swift编译器使用这些信息生成一个非破损符号的映射及其相关的类型信息。

头文件已分配给目标，但仅被标记为项目可见，只是更改为公共导致解决此错误。