针对目标‘AAA’未找到SPM构件 - 仅Xcode 13.3出现该问题

我之前帮不少开发者处理过类似的问题，Xcode 13.3对Swift Package Manager（SPM）的二进制目标解析逻辑做了一些细节调整，尤其是针对xcframework的处理，咱们一步步来排查解决：

可能的原因分析 #

• Xcode 13.3对binaryTarget的路径校验更严格，路径稍有偏差就会找不到构件
• 你的xcframework可能缺少Xcode 13.3支持的架构，或者本身存在兼容性问题
• SPM缓存或Xcode DerivedData堆积导致的解析异常

具体解决步骤 #

1. 先确认xcframework的路径与结构正确性 #

首先检查artifacts/BBB.xcframework这个路径是否和Package.swift处于正确的相对位置：

• 如果Package.swift在项目根目录，那么artifacts文件夹必须和它同级，且里面确实存在完整的BBB.xcframework（不能是文件夹损坏或文件缺失）
• 可以用命令行验证路径：在项目根目录执行ls artifacts/BBB.xcframework，如果能看到里面的子文件夹（比如ios-arm64、ios-x86_64-simulator等）就说明路径没问题

2. 调整Package.swift的配置细节 #

从你提供的代码来看，有几个可以优化的点：

（1）添加明确的平台声明

Xcode 13.3对未指定platforms的Package解析会更严格，建议在Package初始化里添加目标平台：

import PackageDescription
let package = Package(
    name: "AAA",
    platforms: [
        .iOS(.v14), // 根据你的实际需求调整最低版本
        // 如果需要支持其他平台，比如.macOS(.v11)、.watchOS(.v7)等
    ],
    products: [
        .library(
            name: "AAA",
            targets: ["AAA"]),
    ],
    dependencies: [
    ],
    targets: [
        .binaryTarget(
            name: "AAA",
            path: "artifacts/BBB.xcframework" ),
        .testTarget(
            name: "AAATests",
            dependencies: ["AAA"]),
    ]
)

（2）对齐binaryTarget与library的关联逻辑

注意到你的binaryTarget名字是AAA，但对应的xcframework文件名是BBB.xcframework，虽然SPM允许这种命名，但Xcode 13.3可能会出现识别偏差。可以尝试把binaryTarget的名字改成和xcframework一致：

import PackageDescription
let package = Package(
    name: "AAA",
    platforms: [.iOS(.v14)],
    products: [
        .library(
            name: "AAA",
            targets: ["BBB"]), // 这里关联binaryTarget的名字
    ],
    dependencies: [
    ],
    targets: [
        .binaryTarget(
            name: "BBB", // 和xcframework文件名一致
            path: "artifacts/BBB.xcframework" ),
        .testTarget(
            name: "AAATests",
            dependencies: ["AAA"]),
    ]
)

3. 清理缓存彻底重置SPM状态 #

缓存堆积是SPM常见的问题，尤其是跨Xcode版本时：

• 完全关闭Xcode
• 删除Xcode的DerivedData：通过Xcode > File > Workspace Settings，点击DerivedData路径旁的箭头，直接删除整个文件夹
• 清理SPM缓存：打开终端执行rm -rf ~/Library/Caches/org.swift.swiftpm
• 重新打开Xcode，执行File > Packages > Resolve Package Versions，等待解析完成

4. 验证xcframework本身的有效性 #

如果上面的步骤都没用，需要确认xcframework本身是否正常：

• 把BBB.xcframework直接拖到一个空的Xcode项目里，添加到目标的Frameworks、Libraries and Embedded Content中
• 尝试调用SDK的API，如果能正常编译运行，说明xcframework没问题，问题还是出在SPM配置上；如果编译失败，说明xcframework可能损坏或架构不兼容，需要重新生成符合Xcode 13.3要求的xcframework

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