2 构建包 on 编程那些事儿

2.1 创建 Swift 包

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

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

2.1 创建 Swift 包

把可执行代码或可共享的代码打包成一个独立的 Swift 包。

概述

Swift 包是一个目录，其中包含源代码、依赖，并且根目录下有一个 Package.swift 清单文件。Swift 包可以提供库、可执行文件、测试、插件和宏。包清单定义了包里有什么，它本身也是用 Swift 编写的。PackageDescription 的 API 参考定义了组装包清单时用到的类型、属性和函数。

2.2 设置 Swift 工具版本

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

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

2.2 设置 Swift 工具版本

定义使用你的包所需的 Swift 编译器最低版本。

概述

工具版本声明使用该包所需的 Swift 编译器最低版本，并决定如何解析 Package.swift 清单。当你用 swift package init 创建新包时，最低版本会自动设为当前版本。该版本通过注释 // swift-tools-version: 加上 Swift 编译器版本号来指定。按照惯例，这条注释出现在清单的第一行；当指定的版本早于 6.0 时它必须如此；从 Swift 6.0 起，它也可以出现在后面的行上，例如在前导注释之后。版本号是语义化版本，唯一例外是：如果你不写补丁版本，它就推断为 0。

2.3 使用构建配置

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

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

2.3 使用构建配置

控制应用或包的构建配置。

概述

包管理器支持两种通用的构建配置：Debug（默认）和 Release。

Debug

默认情况下，运行 swift build 会使用调试配置构建包；你也可以显式使用 swift build -c debug。包管理器把构建产物放在 .build 文件夹下名为 debug 的目录中。以调试配置构建时，Swift 目标使用下列 Swift 编译器标志：

2.4 按 Swift 版本打包

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

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

2.4 按 Swift 版本打包

为特定 Swift 版本提供包清单。

概述

包管理器支持同时适配多种版本的包：既包括语言版本，也包括提供包管理器的 Swift 工具链版本。

对于与语言相关的版本检查，请使用源代码中可用的语言版本检查。不过在某些情况下，这种做法会变得难以维护，特别是当包清单无法与版本无关时——例如你在包清单中采用了旧版本不具备的新特性。

2.5 为 Swift 包打包资源

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

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

2.5 为 Swift 包打包资源

把资源文件加入 Swift 包，并在代码中访问它们。

概述

如果你在 Package.swift 文件中声明了 // swift-tools-version: 5.3 或更高版本，就可以在 Swift 包中把资源与源代码一起打包。例如，Swift 包可以包含资源目录（asset catalog）、测试夹具等。

2.6 发布与公开 Swift 包

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

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

2.6 发布与公开 Swift 包

共享你包的某个特定版本。

概述

Swift Package Manager 期望包以一个 Git 仓库的形式远程共享，带有一个符合完整语义化版本的标签，并在仓库根目录下有一个 Package.swift 清单。

2.7 生成软件物料清单（SBOM）

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

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

2.7 生成软件物料清单（SBOM）

用 SBOM 文档列出组件与依赖的清单。

概述

Swift Package Manager 可以为 Swift 包和产品生成软件物料清单（SBOM）文档。

目前 Swift Package Manager 支持两种 SBOM 格式：CycloneDX 和 SPDX。

2.8 持续集成工作流

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

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

2.8 持续集成工作流

使用既有的持续集成环境构建 Swift 包，并在既有的 CI 流水线中为使用包依赖的应用做好准备。

概述

持续集成（CI）是自动化并简化应用的构建、分析、测试、归档和发布的过程，以确保应用始终处于可发布状态。大多数包含 Swift 包或依赖 Swift 包的项目都不需要额外配置。

2.9 使用 shell 补全脚本

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

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

2.9 使用 shell 补全脚本

定制你的 shell，让它自动补全 swift package 命令。

概述

包管理器自带 Bash、Zsh 和 Fish 的补全脚本。为你的 shell 生成补全列表即可使用。