构建兼容Objective-C的Swift XCFramework遇导入问题求助

核心问题分析 #

你的XCFramework在Swift项目中正常工作，但Objective-C项目导入失败，主要是因为Objective-C依赖**模块映射文件（module.modulemap）**和自动生成的Swift桥接头文件，当前构建流程存在路径错误、必要文件缺失的问题。

1. 构建脚本的Framework路径错误 #

你当前使用PackageFrameworks下的Framework创建XCFramework，但通过xcodebuild archive生成的合法Framework实际位于归档文件（.xcarchive）的Products/Library/Frameworks/目录下。使用错误路径打包的XCFramework会缺少Objective-C识别模块所需的module.modulemap和MySDK-Swift.h文件。

2. 手动复制SwiftModule的冗余操作 #

xcodebuild -create-xcframework命令会自动将SwiftModule文件打包进XCFramework，无需手动复制。当前手动复制操作不仅多余，还可能因路径错误导致文件放置位置不正确。

3. 模块映射与桥接头文件缺失 #

Objective-C通过module.modulemap识别Swift框架的模块结构，同时依赖MySDK-Swift.h调用Swift接口。如果这两个文件没有被正确包含进XCFramework，就会出现module not found或file not found错误。

修正后的构建脚本 #

替换原脚本，使用归档文件中的正确路径生成XCFramework：

# Build for iOS simulator
xcodebuild \
  -scheme ${SCHEME} \
  -configuration ${CONFIGURATION} \
  -destination "generic/platform=iOS Simulator" \
  -archivePath "${BUILD_DIR}/archives/${SCHEME}-Simulator.xcarchive" \
  BUILD_DIR=${BUILD_DIR} \
  SKIP_INSTALL=NO \
  DEFINES_MODULE=YES \
  SWIFT_INSTALL_OBJC_HEADER=YES \
  BUILD_LIBRARY_FOR_DISTRIBUTION=YES \
  OTHER_SWIFT_FLAGS="-DCOCOAPODS"

# Build for iOS device
xcodebuild \
  -scheme ${SCHEME} \
  -configuration ${CONFIGURATION} \
  -destination "generic/platform=iOS" \
  -archivePath "${BUILD_DIR}/archives/${SCHEME}-Device.xcarchive" \
  BUILD_DIR=${BUILD_DIR} \
  SKIP_INSTALL=NO \
  DEFINES_MODULE=YES \
  SWIFT_INSTALL_OBJC_HEADER=YES \
  BUILD_LIBRARY_FOR_DISTRIBUTION=YES \
  OTHER_SWIFT_FLAGS="-DCOCOAPODS"

# Create XCFramework using valid paths from archives
xcodebuild -create-xcframework \
    -framework "${BUILD_DIR}/archives/${SCHEME}-Device.xcarchive/Products/Library/Frameworks/${SCHEME}.framework" \
    -framework "${BUILD_DIR}/archives/${SCHEME}-Simulator.xcarchive/Products/Library/Frameworks/${SCHEME}.framework" \
    -output "${BUILD_DIR}/${SCHEME}.xcframework"

验证XCFramework结构 #

生成后检查XCFramework的内部结构，确保每个平台的Framework目录下包含以下文件：

• Modules/module.modulemap：模块映射文件
• Modules/${SCHEME}.swiftmodule/：Swift模块元数据
• ${SCHEME}-Swift.h：自动生成的Objective-C桥接头文件

Objective-C项目导入注意事项 #

1. 将XCFramework拖入项目后，确保在Build Phases > Link Binary With Libraries中已添加该框架。
2. 在Objective-C代码中使用模块导入：

   @import MySDK;
   

   避免直接导入头文件（#import "MySDK-Swift.h"），模块导入会自动处理头文件路径。
3. 若遇到非模块化导入警告，将项目的Build Settings > Allow Non-modular Includes in Framework Modules设置为YES。

Swift Package额外优化 #

确保Swift代码中需要暴露给Objective-C的类和方法标记为@objc public，例如：

@objc public class MyPublicClass: NSObject {
    @objc public func myPublicMethod() {
        // ...
    }
}

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