使用Swift Package Manager构建Xcode项目失败：FirebaseUI-Storage依赖问题

背景信息 #

• 从CocoaPods切换至Swift Package Manager(SPM)管理所有依赖
• 使用环境：Xcode 26、Swift 5
• 尝试过的版本：Firebase 11.15.0、Firebase 12.3.0，FirebaseUI-OS/Storage 15.1.0

构建错误信息 #

error: Clang dependency scanner failure: While building module 'FirebaseStorageUI' imported from FirebaseStorageUI-acab814b.input:1:
In file included from <module-includes>:1:
In file included from /Users/myselfLibrary/Developer/Xcode/DerivedData/my-apps-hbhkuwnnplkslocsezmqydmnirnc/SourcePackages/checkouts/FirebaseUI-iOS/FirebaseStorageUI/Sources/Public/FirebaseStorageUI/FirebaseStorageUI.h:26:
/Users/myself/Library/Developer/Xcode/DerivedData/my-apps-hbhkuwnnplkslocsezmqydmnirnc/SourcePackages/checkouts/FirebaseUI-iOS/FirebaseStorageUI/Sources/Public/FirebaseStorageUI/UIImageView+FirebaseStorage.h:34:11: fatal error: module 'FirebaseStorage' not found
FirebaseStorageUI-acab814b.input:1:1: fatal error: could not build module 'FirebaseStorageUI'

解决建议 #

• 核对版本兼容性：确认FirebaseUI-Storage 15.1.0与你使用的Firebase版本是否兼容，部分版本组合可能存在依赖关联问题
• 单独添加FirebaseStorage依赖：直接通过SPM添加FirebaseStorage包，而非仅通过Firebase总包引入，避免子模块关联失效
• 清理Derived Data：删除项目对应的Derived Data文件夹（路径：~/Library/Developer/Xcode/DerivedData/[你的项目文件夹]），重启Xcode后重新构建
• 检查Build Settings配置：确保Framework Search Paths包含SPM下载的FirebaseStorage路径，同时确认Enable Modules (C and Objective-C)选项处于开启状态
• 验证依赖链接状态：在「Frameworks, Libraries, and Embedded Content」中，确认FirebaseStorage和FirebaseStorageUI的状态均为「Embed & Sign」，且无红色警告
• 检查导入语句：Swift文件中确保同时导入import FirebaseStorage和import FirebaseStorageUI；Objective-C文件中确认@import FirebaseStorage;和@import FirebaseStorageUI;均正确添加

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