3.1 为 Swift 包添加依赖 on 编程那些事儿

3.1.1 解析与更新依赖

Fri, 11 Sep 2026 21:45:00 +0800

原文链接: https://docs.swift.org/latest/documentation/packagemanagerdocs/resolvingpackageversions/

3.1.1 解析与更新依赖

为你的包协调并约束依赖。

概述

包管理器把依赖解析的结果记录在包顶层名为 Package.resolved 的文件中。当该文件存在，并且你正在为依赖树的顶层（叶子）包解析依赖时，包管理器会把 Package.resolved 文件用作各依赖版本的缓存。对于作为库使用、或作为另一个 Swift 项目依赖而引入的包，Package.resolved 文件并不会固定它们所依赖的版本。如果该包是作为另一个包的依赖被解析的，那么它自己的 Package.resolved 文件在那次解析中会被忽略。

3.1.2 用特性提供可配置的包

Fri, 11 Sep 2026 21:45:00 +0800

原文链接: https://docs.swift.org/latest/documentation/packagemanagerdocs/packagetraits/

3.1.2 用特性提供可配置的包

定义一个或多个包特性，为包提供默认功能和可配置功能。

概述

在 6.1 版本之前，Swift 包对每个版本提供的都是一套不可配置的 API。从 Swift 6.1 开始，包可以提供特性（trait），用来表达该包的一套可配置 API。

3.1.3 解决依赖失败

Fri, 11 Sep 2026 21:45:00 +0800

原文链接: https://docs.swift.org/latest/documentation/packagemanagerdocs/resolvingdependencyfailures/

3.1.3 解决依赖失败

了解各种依赖失败的场景。

概述

在把依赖添加到包中时，你会为它们定义约束，而这些约束并不总能被满足。

在运行构建或测试之前，或者当你运行 swift package resolve 时，包管理器会遍历你的包中的依赖，以及它们递归的所有依赖，从而构建出一份完整列表。然后它会尝试为每个依赖选出一个版本，使其既符合你的包的约束，也符合你的依赖所提供的任何约束。

3.1.4 添加对系统库的依赖

Fri, 11 Sep 2026 21:45:00 +0800

原文链接: https://docs.swift.org/latest/documentation/packagemanagerdocs/addingsystemlibrarydependency/

3.1.4 添加对系统库的依赖

定义库的位置，并提供模块映射，把 C 头文件暴露给 Swift。

概述

你可以借助包管理器链接系统库，把它们当作代码中的依赖使用。为此，添加一个 systemLibrary 类型的 target，并为你使用的每个系统库提供一个 module.modulemap。

3.1.5 使用系统库依赖与 pkg-config 的示例

Fri, 11 Sep 2026 21:45:00 +0800

原文链接: https://docs.swift.org/latest/documentation/packagemanagerdocs/examplesystemlibrarypkgconfig/

3.1.5 使用系统库依赖与 pkg-config 的示例

创建一个把 libgit2 作为系统库依赖使用的命令行可执行文件包。

概述

下面的示例完整演示了创建一个依赖 libgit2 的二进制可执行文件的过程。

3.1.6 编辑包所用的远程依赖

Fri, 11 Sep 2026 21:45:00 +0800

原文链接: https://docs.swift.org/latest/documentation/packagemanagerdocs/editingdependencypackage/

3.1.6 编辑包所用的远程依赖

把远程依赖临时切换为本地依赖，以便编辑该依赖。

概述

当你的工作需要改动某个依赖时（例如修复一个缺陷，或添加一个新 API），Swift 包管理器支持编辑依赖。包管理器会把这个依赖移动到一个可编辑的 Packages/ 目录下。