如何在Xcode独立空白模板Playground中添加Swift包依赖？

一、独立空白Playground添加Swift包依赖 #

独立Playground无法使用Xcode的Swift包依赖按钮，可通过以下两种方式解决：

方法1：手动用SPM构建依赖并关联 #

1. 在Playground文件所在的文件夹中，新建一个Package.swift文件，填入以下模板内容（替换成你的依赖信息）：

// swift-tools-version:5.8
import PackageDescription

let package = Package(
    name: "PlaygroundDeps",
    dependencies: [
        // 替换为你的自定义包仓库地址和版本要求
        .package(url: "https://github.com/xxx/YourCustomPackage.git", from: "1.0.0")
    ],
    targets: [
        .target(
            name: "PlaygroundDeps",
            // 替换为你的自定义包的target名称
            dependencies: ["YourCustomPackage"]),
    ]
)

2. 打开终端，切换到该文件夹目录，执行swift build命令，让Swift Package Manager下载并编译依赖包。
3. 回到Xcode的Playground，点击顶部菜单 File > Add Files to "xxx.playground"...，选择编译后生成的 .build/debug/YourCustomPackage.swiftmodule 文件（位于Playground所在文件夹的.build/debug目录下）。
4. 此时即可在Playground中正常import YourCustomPackage并使用。

方法2：将依赖编译为.framework导入 #

1. 打开你的自定义包项目，选择对应的目标平台（如iOS、macOS），执行Command+B编译生成.framework文件。
2. 找到编译后的.framework文件（通常在~/Library/Developer/Xcode/DerivedData/对应的项目目录下），将其拖入独立Playground的Resources目录中。
3. 在Playground的右侧检查器中，确保该.framework的“Target Membership”已勾选当前Playground。
4. 完成后即可在Playground中导入并使用该库。

二、项目内Playground无法导入已添加的包依赖 #

如果项目已成功添加自定义包依赖，但内部Playground无法导入，可按以下步骤排查：

• 匹配平台设置：确保Playground的平台（右侧检查器的“Platform”选项）与项目Target的平台完全一致（比如项目是iOS 16，Playground不能选macOS）。
• 关联依赖库：进入项目Target的Build Phases > Link Binary With Libraries，确认已添加该自定义包的.framework文件。
• 清理重构：执行Command+Shift+K清理项目，再执行Command+B重新构建整个项目，之后再打开Playground尝试导入。
• 检查构建配置：在Playground右侧检查器中，将“Build Configuration”设置为Debug（与包依赖默认的编译配置一致）。

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