在 Swift Package Manager (SPM) 的实际开发中，混合使用版本化远程库（Versioned） 、**本地模块（Local）和二进制框架（Binary）**是大型项目解耦、加速编译以及代码保护的常规操作。
通过 Package.swift 的精细化配置，你可以构建出一个高度灵活的开发环境。
1. 混合使用的核心配置架构
在 Package.swift 中，这三种形态的依赖共存于 dependencies 和 targets 数组。
A. 版本化远程包 (Semantic Versioning)
这是最常见的用法，适用于成熟的第三方开源库。
- 特点：基于 Git Tag 自动解析，支持 SemVer 版本协商。
B. 本地包开发 (Local Development)
适用于你正在频繁修改的模块，或者作为 Monorepo 的一部分。
- 特点：使用相对路径引用。注意： Xcode 会优先加载本地路径下的代码。
C. 二进制包 (Binary Frameworks)
适用于闭源 SDK 或极其庞大、编译耗时过长的基础库。
- 特点：引入
.xcframework，无需源代码，极大提升编译速度。
2. 实战配置示例
以下是一个典型的混合依赖 Package.swift 文件结构：
Swift
// swift-tools-version: 5.9
import PackageDescription
let package = Package(
name: "CoreInfrastructure",
platforms: [.iOS(.v15)],
products: [
.library(name: "AppEngine", targets: ["AppEngine"])
],
dependencies: [
// 1. 版本化远程依赖
.package(url: "https://github.com/Alamofire/Alamofire.git", from: "5.8.0"),
// 2. 本地依赖 (假设在同级目录下)
.package(path: "../SharedUtilities")
],
targets: [
// 3. 二进制依赖目标 (远程或本地)
.binaryTarget(
name: "ClosedSourceSDK",
url: "https://myserver.com/sdk/v1.0.0/SDK.xcframework.zip",
checksum: "a1b2c3d4e5f6..." // 通过 swift package compute-checksum 获取
),
// 4. 混合业务 Target
.target(
name: "AppEngine",
dependencies: [
"Alamofire", // 使用远程库
"SharedUtilities", // 使用本地库
"ClosedSourceSDK" // 使用二进制库
]
)
]
)
3. 混合开发的进阶技巧
技巧一：利用本地覆盖实现“即时调试”
如果你在开发 App 时发现某个远程依赖库有 Bug，无需去修改远程仓库。
- 将该远程库
git clone到本地。 - 在 Xcode 的工程中直接将该文件夹拖入工程侧边栏。
- SPM 会自动识别同名的本地 Package 并覆盖（Override）远程版本。这让你可以在不改变
Package.swift的情况下调试第三方库。
技巧二：二进制包的校验与版本化
二进制包通常通过 URL 引入，为了保证安全和缓存一致性，checksum 是强制要求的。
- 开发建议：在内部私有 SDK 发布时，可以编写一个脚本，在生成
.xcframework的同时，自动更新Package.swift中的url和checksum。
技巧三：条件编译与平台隔离
在混合模式下，二进制包往往只支持特定平台（如仅 iOS）。你可以利用条件依赖避免编译错误：
Swift
.target(
name: "Feature",
dependencies: [
.condition(.target(name: "iOSOnlySDK"), .when(platforms: [.iOS]))
]
)
4. 常见问题与解决方案
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 本地包无法解析 | 相对路径不正确或文件夹内缺少 .git | 确保 path 指向包含 Package.swift 的目录。 |
| 二进制包符号重复 | 同时链接了静态库和包含该库的二进制 SDK | 检查依赖树，确保二进制 SDK 内部没有嵌入已有的静态 target。 |
| 版本冲突 | 远程包的版本约束与本地包不匹配 | 显式在根 Package.swift 中锁定版本，SPM 会优先遵循根部的声明。 |
总结建议：合理规划混合模式
- 本地化高频修改：将核心业务模块设为本地路径，享受修改代码后“秒级预览”的快感。
- 二进制化稳定底层：将网络底层、日志系统等不再变动的庞大模块封装为二进制包，减少整机编译时间。
- 语义化外部依赖：对开源社区库保持 SemVer 约束，以便及时获取安全更新。
