Swift Package在多平台App中macOS端导入编译失败求助

这种跨平台Swift Package的导入问题我碰到过好几次，大概率是配置不匹配或者缓存干扰导致的，给你几个一步步排查的方案：

1. 先检查Package.swift的平台声明是否正确 #

首先确认你的ConfettiSwiftUI包的Package.swift文件里，已经明确包含了macOS的支持，并且版本符合SwiftUI的要求（至少macOS 10.15+）。打开包的Package.swift，查看platforms部分：

let package = Package(
    name: "ConfettiSwiftUI",
    platforms: [
        .iOS(.v13),
        .macOS(.v10_15) // 必须包含这一行，版本不能低于SwiftUI要求
    ],
    products: [
        .library(name: "ConfettiSwiftUI", targets: ["ConfettiSwiftUI"]),
    ],
    targets: [
        .target(name: "ConfettiSwiftUI"),
    ]
)

另外还要检查targets里有没有单独限制平台的配置，如果某个target只指定了iOS，那macOS端自然无法导入。

2. 验证多平台App的macOS目标配置 #

打开你的多平台App项目，选中macOS的target：

• 进入General标签，查看「Deployment Info」里的macOS版本，确保它不低于Package.swift中声明的macOS最低版本。
• 切换到Build Settings，搜索「Swift Language Version」，确认版本和你的Swift Package使用的版本一致（比如都是Swift 5.7+）。

3. 清理缓存并重新解析Package #

Xcode的缓存经常会搞出奇怪的问题，试试彻底清理：

• 按下Command + Shift + K清理当前项目的构建文件夹。
• 再按下Command + Option + Shift + K清理派生数据（Derived Data）。
• 然后点击Xcode顶部菜单的「File」→「Packages」→「Reset Package Caches」，等待Xcode重新下载并解析你的Package。
• 如果还是不行，可以手动删除Derived Data文件夹：路径是~/Library/Developer/Xcode/DerivedData，找到对应项目的文件夹删掉，再重启Xcode。

4. 检查Package内的跨平台兼容性 #

如果你的Package里有iOS专属的API（比如UIKit相关代码），但没有用条件编译包裹，macOS端编译就会报错。检查包内的代码，确保平台专属逻辑用#if os(macOS)或#if os(iOS)区分：

#if os(iOS)
import UIKit
#elseif os(macOS)
import AppKit
#endif

// 比如这样处理平台专属的视图或API
func somePlatformSpecificLogic() {
    #if os(iOS)
    // iOS专属代码
    #elseif os(macOS)
    // macOS专属代码
    #endif
}

另外还要检查Package的依赖，有没有只支持iOS的第三方库，如果有，要么替换成跨平台版本，要么在Package里针对macOS排除该依赖。

5. 重新添加Package到多平台项目 #

有时候添加Package时的目标选择有误，试试重新添加：

• 在项目导航器里找到「Packages」目录，右键点击ConfettiSwiftUI，选择「Remove Package」。
• 点击Xcode顶部菜单的「File」→「Add Packages...」，输入你的仓库地址。
• 在添加界面，确保「Add to Target」选项里勾选了你的macOS target（或者选择「All targets」），然后点击「Add Package」。

6. 确认Xcode版本兼容性 #

如果你的Package使用了较新的macOS API（比如macOS 13的新特性），但你用的Xcode版本太旧（比如Xcode 13不支持macOS 13），也会导致导入失败。确保你的Xcode版本支持你设置的macOS部署版本，必要时升级到最新版Xcode。

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