Swift Package Manager 项目

Swift Package Manager 是一种用于管理源代码分发的工具,旨在简化代码共享和代码重用的过程。 该工具直接解决了编译和链接 Swift 包、管理依赖项、版本控制以及支持灵活的分发和协作模式等挑战。

我们设计的系统旨在方便在 GitHub 等服务上共享包,但包也非常适合私人个人开发、团队内部共享代码或任何其他粒度级别。

Swift Package Manager 包含一个可以为 macOS 和 Linux 构建的构建系统。 从 Xcode 11 开始,Xcode 与 SwiftPM 集成,为在 iOS、macOS、watchOS 和 tvOS 应用程序中包含包提供支持。

SourceKit-LSP 项目利用 libSwiftPM 并为支持 LSP 的编辑器提供 Language Server Protocol 实现。


目录


入门

请使用本指南学习 package manager 的基础知识。


文档

如需快速帮助,请使用 swift package --help 命令。

有关使用 Swift Package Manager、创建包等的文档,请参阅文档目录

有关开发 Swift Package Manager 本身的文档,请参阅贡献指南

有关包清单 API 的详细文档,请参阅 PackageDescription API

有关版本之间更改信息的发行说明,请参阅发行说明


系统要求

package manager 的系统要求与 Swift 的系统要求相同,但 package manager 需要在运行时和构建时都使用 Git。


安装

package manager 可作为 Swift 工具链的一部分在 Swift.org 上获得),包括从 main 分支构建的最新版本的快照。 有关下载的快照的安装说明,请参阅 Swift.org 的入门 部分。

Swift Package Manager 也包含在 Xcode 8.0 和所有后续版本中。

您可以通过在终端中输入 swift package --version 来验证您的安装。

$ swift package --version
Apple Swift Package Manager - ...

贡献

您可以通过多种方式为 Swift Package Manager 做出贡献。 要了解管理 Swift 项目贡献的政策、最佳实践以及设置开发环境的说明,请阅读贡献者指南

Swift package manager 使用 llbuild 作为编译源文件的底层构建系统。 它也是开源的,并且是 Swift 项目的一部分。


报告问题

如果您在使用 package manager 时遇到任何问题,可以获得帮助。 我们建议您查看

报告问题时,请遵循 bug 报告指南,可以在贡献指南中找到。

如果您不希望在列表中分享您的问题,可以在 CODEOWNERS 中找到代码所有者的联系方式; 但是,Swift 论坛通常是寻求帮助的最佳场所。


许可

版权所有 2015 - 2023 Apple Inc. 和 Swift 项目作者。 在 Apache License v2.0 下获得许可,带有运行时库例外。

有关许可信息,请参阅 https://swiftlang.cn/LICENSE.txt

有关 Swift 项目作者,请参阅 https://swiftlang.cn/CONTRIBUTORS.txt