通过Package.swift添加依赖时Swift Package产品无法找到

可能的原因与修复步骤 #

1. 明确指定依赖的产品与包名 #

手动编写Package.swift时，SPM有时需要明确关联产品所属的包，避免解析歧义。将目标依赖的写法从直接写"Sentry"改为指定product和package：

修改后的Package.swift代码：

// swift-tools-version: 5.9
// The swift-tools-version declares the minimum version of Swift required to build this package.

import PackageDescription

let package = Package(
    name: "MyPackage",
    platforms: [
        .iOS(.v15)
    ],
    products: [
        .library(
            name: "MyPackage",
            targets: ["MyPackage"]),
    ],
    dependencies: [
        .package(url: "https://github.com/getsentry/sentry-cocoa", from: "8.24.0")
    ],
    targets: [
        .target(
            name: "MyPackage",
            dependencies: [
                .product(name: "Sentry", package: "Sentry")
            ]),
        .testTarget(
            name: "MyPackageTests",
            dependencies: ["MyPackage"]),
    ]
)

Xcode GUI添加依赖时会自动完成这层关联，但手动配置容易遗漏，这是导致产品找不到的常见原因。

2. 清理SPM缓存 #

如果修改配置后仍无法解决，可能是缓存导致的解析异常。执行以下命令清理缓存：

rm -rf ~/Library/Caches/org.swift.swiftpm
rm -rf ~/Library/Developer/Xcode/DerivedData

清理后重新打开项目，执行File > Packages > Update to Latest Package Versions，重新解析依赖。

3. 验证版本兼容性 #

确认你的Xcode版本（对应Swift 5.9即Xcode 15）与Sentry 8.24.0兼容。如果存在版本适配问题，可以尝试指定更具体的版本范围，例如：

.package(url: "https://github.com/getsentry/sentry-cocoa", .upToNextMajor(from: "8.24.0"))

或直接锁定一个已知兼容的版本号。

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