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 项目的一部分。


报告问题

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

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

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


许可证

版权所有 2015 - 2022 Apple Inc. 和 Swift 项目作者。根据 Apache License v2.0 许可,包含运行时库例外。

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

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