Xcode13.3运行MasterPass示例App遇bridging headers模块接口不兼容错误

环境说明 #

• 系统：macOS Monterey
• 设备：2018款Mac mini（32GB）
• 工具：Xcode 13.3
• 目标：运行MasterPass官方沙箱示例App，调试后集成到自有项目
• 核心编译错误：error: using bridging headers with module interfaces is unsupported

已解决的编译错误及修复步骤 #

• 错误1：building for ios simulator, but the linked and embedded framework 'mcc merchant.framework' was built for ios + ios simulator
  修复：将目标Target的Build Settings中Validate Workspace设为YES
• 错误2：module compiled with swift 5.0 cannot be imported by the swift 5.6 compiler
  修复：Build Settings > Build Options > Build Libraries for Distribution设为Yes
• 错误3：增量编译禁用提示
  修复：Build Settings > Swift Compiler > Compilation Mode设为Incremental

尝试过但无效的修复操作 #

为替换原有桥接文件，执行了以下步骤但未解决问题：

1. 创建BridgingMerchantModule.modulemap文件，用于向Swift暴露Objective-C头文件
2. 原桥接文件MerchantCheckoutApp-Bridging-Header.h内容：

//
//  Use this file to import your target's public headers that you would like to expose to Swift.
//

#import "SDWebImage/UIImageView+WebCache.h"

3. modulemap文件内容：

module BridgingMerchantModule {
    header "SDWebImage/UIImageView+WebCache.h"
    export *
}

4. 移除项目中原有的MerchantCheckoutApp-Bridging-Header.h文件
5. 在Project Settings > Build Settings > Swift Compiler - Search Paths > Import Paths中添加module map文件路径

完整编译日志 #

Compile Swift source files (x86_64)
CompileSwiftSources normal x86_64 com.apple.xcode.tools.swift.compiler (in target 'MerchantCheckoutApp' from project 'MerchantCheckoutApp')
    cd /Users/user226714/Desktop/masterpass_merchant_ios_sdk_v280-2/SampleSourceCode/MerchantCheckoutApp
    export DEVELOPER_DIR\=/Applications/Xcode13.3.app/Contents/Developer
    export SDKROOT\=/Applications/Xcode13.3.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator15.4.sdk
    /Applications/Xcode13.3.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/swiftc -incremental -module-name MerchantCheckoutApp -O -enable-batch-mode -enforce-exclusivity\=checked @/Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/MerchantCheckoutApp.build/Release-iphonesimulator/MerchantCheckoutApp.build/Objects-normal/x86_64/MerchantCheckoutApp.SwiftFileList -DDEBUG -sdk /Applications/Xcode13.3.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator15.4.sdk -target x86_64-apple-ios9.0-simulator -g -module-cache-path /Users/user226714/Library/Developer/Xcode/DerivedData/ModuleCache.noindex -Xfrontend -serialize-debugging-options -enable-testing -enable-library-evolution -swift-version 4 -I /Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Products/Release-iphonesimulator -F /Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Products/Release-iphonesimulator -F /Users/user226714/Desktop/masterpass_merchant_ios_sdk_v280-2/SampleSourceCode/MerchantCheckoutApp/Carthage/Build/iOS -F MerchantCheckoutApp/ExternalComponents -c -j4 -output-file-map /Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/MerchantCheckoutApp.build/Release-iphonesimulator/MerchantCheckoutApp.build/Objects-normal/x86_64/MerchantCheckoutApp-OutputFileMap.json -parseable-output -serialize-diagnostics -emit-dependencies -emit-module -emit-module-path /Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/MerchantCheckoutApp.build/Release-iphonesimulator/MerchantCheckoutApp.build/Objects-normal/x86_64/MerchantCheckoutApp.swiftmodule -emit-module-interface-path /Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/MerchantCheckoutApp.build/Release-iphonesimulator/MerchantCheckoutApp.build/Objects-normal/x86_64/MerchantCheckoutApp.swiftinterface -Xcc -I/Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/MerchantCheckoutApp.build/Release-iphonesimulator/MerchantCheckoutApp.build/swift-overrides.hmap -Xcc -iquote -Xcc /Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/MerchantCheckoutApp.build/Release-iphonesimulator/MerchantCheckoutApp.build/MerchantCheckoutApp-generated-files.hmap -Xcc -I/Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/MerchantCheckoutApp.build/Release-iphonesimulator/MerchantCheckoutApp.build/MerchantCheckoutApp-own-target-headers.hmap -Xcc -I/Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/MerchantCheckoutApp.build/Release-iphonesimulator/MerchantCheckoutApp.build/MerchantCheckoutApp-all-target-headers.hmap -Xcc -iquote -Xcc /Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/MerchantCheckoutApp.build/Release-iphonesimulator/MerchantCheckoutApp.build/MerchantCheckoutApp-project-headers.hmap -Xcc -I/Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Products/Release-iphonesimulator/include -Xcc -I/Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/MerchantCheckoutApp.build/Release-iphonesimulator/MerchantCheckoutApp.build/DerivedSources-normal/x86_64 -Xcc -I/Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/MerchantCheckoutApp.build/Release-iphonesimulator/MerchantCheckoutApp.build/DerivedSources/x86_64 -Xcc -I/Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/MerchantCheckoutApp.build/Release-iphonesimulator/MerchantCheckoutApp.build/DerivedSources -Xcc -DDEBUG\=1 -emit-objc-header -emit-objc-header-path /Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/MerchantCheckoutApp.build/Release-iphonesimulator/MerchantCheckoutApp.build/Objects-normal/x86_64/MerchantCheckoutApp-Swift.h -import-objc-header /Users/user226714/Desktop/masterpass_merchant_ios_sdk_v280-2/SampleSourceCode/MerchantCheckoutApp/MerchantCheckoutApp/Modules/BridgingMerchantModule.modulemap -pch-output-dir /Users/user226714/Library/Developer/Xcode/DerivedData/MerchantCheckoutApp-evrhdgvhehrtuybmevsukiurddrn/Build/Intermediates.noindex/PrecompiledHeaders -working-directory /Users/user226714/Desktop/masterpass_merchant_ios_sdk_v280-2/SampleSourceCode/MerchantCheckoutApp

error: using bridging headers with module interfaces is unsupported
Command CompileSwiftSources failed with a nonzero exit code

可行修复方案 #

方案1：禁用模块接口生成 #

开启Build Libraries for Distribution会强制生成模块接口，而模块接口与桥接机制不兼容。可通过以下步骤禁用当前Target的模块接口生成：

1. 打开目标Target的Build Settings
2. 搜索Swift Compiler - Custom Flags
3. 在Other Swift Flags中添加：-Xfrontend -no-emit-module-interface
4. 清理编译缓存后重新编译

方案2：清理桥接配置残留 #

从编译日志可见，编译器仍在尝试导入modulemap文件，可能是项目配置残留导致：

1. 打开Target的Build Settings，搜索Objective-C Bridging Header，确保该字段为空
2. 删除之前添加的Import Paths配置
3. 清理DerivedData：Xcode菜单 > Product > Clean Build Folder（快捷键⇧⌘K），再手动删除~/Library/Developer/Xcode/DerivedData下对应项目的文件夹
4. 重新编译项目

方案3：直接导入SDWebImage模块 #

如果SDWebImage是通过Carthage/CocoaPods引入的标准框架，无需桥接文件或modulemap，直接在Swift文件中导入即可：

import SDWebImage

之后删除所有桥接相关的文件和配置，重新编译。

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