Swift Package Manager (SPM)：Swift 开发者完整指南

\n\n

Swift Package Manager (SPM) 是用于管理 Swift 语言代码依赖项、构建和分发的官方工具。SPM 直接内置于 Swift 生态系统中，提供了一种统一且标准化的包管理方式，使开发者无需使用 CocoaPods 或 Carthage 等第三方解决方案。SPM 与 Swift 编译器和 Xcode 紧密集成，使其成为现代项目的理想选择。

\n\n

为什么需要 Swift Package Manager？首先，用于管理依赖项。任何非平凡项目都会使用第三方库：用于网络操作（Alamofire、URLSession）、JSON 解析（SwiftyJSON）、数据库操作（GRDB、SQLite.swift）等。SPM 会自动下载、构建并将这些库链接到您的项目中。其次，SPM 允许您自己创建和发布自己的包，使您的代码可重复使用。第三，它提供了强大的项目构建工具，包括对测试、资源和插件的支持。

\n\n

与 CocoaPods 不同，SPM 不需要安装单独的 Ruby gem 或配置复杂的 Podfile。与 Carthage 不同，SPM 不需要手动链接框架。SPM 是一个“原生”包管理器，开箱即用地理解 Swift 项目的结构。它使用 Package.swift 文件来描述项目及其依赖项，使配置过程透明且可预测。

\n\n

安装

\n\n

Swift Package Manager 随官方 Swift 发行版一起提供。无需单独安装。如果您已安装 Swift（从 5.0 版本开始），则 SPM 已在您的系统中可用。

\n\n

检查安装：

\n

swift --version

\n

如果您看到 Swift 版本，则 SPM 已准备就绪。您也可以检查该工具本身是否存在：

\n

swift package --version

\n\n

安装 Swift（如果未安装）：

\n

\n
• macOS：从 Mac App Store 安装 Xcode。Swift 和 SPM 是其组成部分。
\n
• Linux（Ubuntu、CentOS、Amazon Linux）：从官方网站 swift.org 下载并安装发行版。
\n
• Windows：从 swift.org 下载并安装发行版。
\n

\n\n

快速开始

\n\n

让我们使用 SPM 创建一个新的可执行项目。这是一个最小的工作示例。

\n\n

1. 创建项目：

\n

mkdir MySwiftProject\ncd MySwiftProject\nswift package init --type executable

\n

此命令将创建项目结构：

\n

\n
• Package.swift — 清单文件。
\n
• Sources/MySwiftProject/main.swift — 入口点。
\n
• Tests/ — 测试目录。
\n

\n\n

2. Package.swift 的内容：

\n

// swift-tools-version:5.9\nimport PackageDescription\n\nlet package = Package(\n    name: "MySwiftProject",\n    targets: [\n        .executableTarget(\n            name: "MySwiftProject"\n        )\n    ]\n)

\n\n

3. main.swift 的内容：

\n

print("Hello, Swift Package Manager!")

\n\n

4. 构建和运行：

\n

swift build\nswift run

\n

您应该在控制台中看到：Hello, Swift Package Manager!

\n\n

主要方法、函数和类

\n\n

让我们看看您每天都会遇到的 SPM 关键元素。主要是由 PackageDescription 模块提供的 API