将Framework转为XCFramework后，Swift无法识别Umbrella Header导入文件

针对你遇到的问题，以下是几个可落地的排查和解决步骤：

1. 确认OC头文件的Target Membership与可见性 #

• 打开Umbrella Header（MySDK.h）中导入的所有OC头文件，检查它们的Target Membership：
  • 如果是对外暴露的公共头，设为Public；如果是Framework内部使用的私有头，设为Private或Project。
• 检查Build Settings中的Public Headers Folder Path（默认$(CONTENTS_FOLDER_PATH)/Headers）和Private Headers Folder Path（默认$(CONTENTS_FOLDER_PATH)/PrivateHeaders），确保头文件被正确归类到对应目录。

2. 调整Modulemap配置适配私有头 #

如果Framework内部有私有OC头需要被Swift访问，默认的modulemap只导出公共模块，需补充私有模块声明：

framework module MySDK {
    umbrella header "MySDK.h"
    
    export *
    module * { export * }

    // 新增私有模块，用于内部Swift访问私有OC头
    private framework module MySDK_Private {
        umbrella header "MySDK_Private.h" // 创建一个包含所有内部私有OC头的Umbrella文件
        export *
        module * { export * }
    }
}

之后在内部Swift文件中导入私有模块：

import MySDK_Private

3. 检查Module相关Build Settings #

• 确保Defines Module设为YES
• 确认Module Name与modulemap中声明的MySDK完全一致
• 开启Enable Module Interfaces（设为YES）
• 清理项目缓存：执行Cmd+Shift+K清理编译产物，手动删除Derived Data（路径：~/Library/Developer/Xcode/DerivedData），重启Xcode后重新编译。

4. 修正Swift文件的导入方式 #

Framework内部的Swift文件无需单独导入Umbrella Header，直接通过模块导入即可：

import MySDK

如果是访问私有头，则导入上面定义的MySDK_Private模块。

5. 验证OC头文件的语法规范性 #

检查所有OC头文件是否存在语法错误（比如重复的类声明、未闭合的括号等），模块解析对语法要求严格，即使跳转定义正常，语法错误也会导致Swift无法识别。

6. 确认XCFramework打包时的资源包含 #

打包XCFramework时，确保modulemap文件和所有必要的头文件被包含进产物：

• 在Build Phases中添加Copy Files阶段，将modulemap文件（通常在Modules目录下）的目标路径设为$(CONTENTS_FOLDER_PATH)/Modules，并勾选Code Sign on Copy。

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