Swift Package Manager无法添加AWS iOS SDK的问题求助

以下是按优先级排序的排查与解决步骤：

1. 先排查网络与仓库访问问题 #

• 确认Mac能正常访问GitHub，直接在浏览器打开AWS SDK的SPM仓库页面，检查是否能正常加载。如果访问卡顿或失败，切换网络（比如手机热点），或者检查系统代理设置——Xcode会沿用系统代理，确保代理没有拦截GitHub请求。
• 手动克隆仓库到本地验证：打开终端执行 git clone https://github.com/aws-amplify/aws-sdk-ios-spm.git，如果克隆失败，说明网络或仓库访问权限有问题；如果克隆成功，回到Xcode尝试添加本地路径的包（添加时选「Add Local...」指向克隆的文件夹）。

2. 明确设置Swift编译器版本 #

当前Swift版本设为「unspecified」，可能和AWS SDK的最低版本要求不兼容。AWS iOS SDK的SPM包通常要求Swift 5.x以上，建议手动指定版本：

1. 打开.xcodeproj，选中项目根节点
2. 切换到「Build Settings」标签
3. 搜索「Swift Language Version」，设置为「Swift 5」
4. 执行 Cmd+Shift+K 清理项目，再重新尝试添加包依赖。

3. 手动创建Package.swift绕开UI问题 #

如果当前项目没有Packages.swift，手动创建一个可能解决Xcode UI层面的异常：

1. 在项目根目录新建Package.swift文件，填入以下内容（替换占位符为你的项目信息）：

// swift-tools-version: 5.9
import PackageDescription

let package = Package(
    name: "YourProjectName",
    platforms: [
        .iOS(.v13) // 根据项目最低iOS版本调整，AWS SDK通常要求iOS13+
    ],
    dependencies: [
        .package(url: "https://github.com/aws-amplify/aws-sdk-ios-spm.git", from: "2.39.0") // 替换为仓库最新稳定版本号
    ],
    targets: [
        .target(
            name: "YourTargetName", // 替换为项目target名称
            dependencies: [
                // 按需添加需要的AWS模块，比如AWSCognitoIdentityProvider、AWSAppSync等
                .product(name: "AWSCognitoIdentityProvider", package: "aws-sdk-ios-spm"),
            ]
        )
    ]
)

2. 保存后，在Xcode中打开这个Package.swift，或通过「File」>「Add Packages...」选择本地的Package.swift关联项目。

4. 重置Xcode的SPM缓存 #

Xcode的包缓存损坏也可能导致异常，尝试清空：

• 关闭Xcode
• 打开终端执行：

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

• 重新打开Xcode，再尝试添加包。

5. 指定SDK的具体版本 #

添加包时，不要选择「Up to Next Major」这类宽泛的版本范围，直接指定仓库的最新稳定版本号（可去仓库Releases页面查看），避免版本兼容问题。

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