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 实现。


目录


入门指南

请使用本指南学习包管理器基础知识。


文档

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

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

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

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

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


系统要求

包管理器的系统要求与 Swift 的系统要求 相同,但需要注意的是,包管理器在运行时和构建时都需要 Git。


安装

包管理器作为 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 包管理器使用 llbuild 作为编译源文件的底层构建系统。它也是开源的,并且是 Swift 项目的一部分。


报告问题

如果您在使用包管理器时遇到任何问题,可以获得帮助。我们建议

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

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


许可证

版权所有 2015 - 2024 Apple Inc. 和 Swift 项目作者。根据 Apache License v2.0 和 Runtime Library Exception 许可。

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

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