文章

使用 Xcode 发布 Swift 软件包

以私密的方式发布你的 Swift 软件包,或者与其他开发者公开分享。

概览

通过在线提供你的 Swift 软件包,你可以利用 Xcode 中对 Swift 软件包依赖项的支持。在将 Swift 软件包发布到私有 Git 储存库后,你可以在多个项目中管理和集成内部依赖项,从而减少重复代码并提高可维护性。你可以公开发布软件包,与世界各地的开发者共享你的代码。若要开始,你只需要拥有 Swift 软件包,并且在托管 Git 储存库提供商处设立账户。

提供 Swift 软件包的相关信息

每个新建的 Swift 软件包均附带一个空的 Readme.md 文件,你可以修改该文件。你可以考虑在 README 文件中添加充足的信息,让其他开发者知道如何使用你的 Swift 软件包,例如:

  • Swift 软件包的功能描述

  • 许可信息

  • 支持的平台和 Swift 版本

  • 联系信息

一些开发者甚至还选择在 README.md 文件中包含教程或使用说明文档。

将本地 Swift 软件包置于版本控制下

使用 Xcode 创建新的 Swift 软件包时,请在用于新建软件包的页面中选择“Create Git repository on my Mac”(在我的 Mac 上创建 Git 储存库)。如果你之后想要将本地软件包置于版本控制下,便可以使用 Xcode 来操作。打开你的 Swift 软件包,选择“Source Control”(源代码控制) 菜单,选取“Create Git Repositories”(创建 Git 储存库),再选中软件包旁边的复选框,然后点按“Create”(创建)。

这个过程会初始化一个 Git 储存库,将你的软件包添加到暂存区,并提交你的文件。

截屏中显示了按照说明将独立 Swift 软件包置于版本控制下时出现的对话框。

标记你的最新提交

最佳的做法是为 Swift 软件包创建版本标签,但也有其他方式可将软件包添加到项目中,如“为你的 App 添加软件包依赖项”中所述。要创建版本标签,请给最近的提交标上软件包版本。“软件包版本”由三个用句点分隔的整数构成。例如 1.0.0。软件包版本必须遵循语义版本控制,从而确保在开发者将软件包依赖项更新为较新版本时,你的软件包会以可预测的方式工作。

要进一步了解语义版本管理标准,请访问 semver.org (英文)

在“Source Code Navigator”(源代码控制导航器) 中,点按“Branches”(分支) 旁边的展开三角形以显示分支列表,然后选择一个分支。在历史记录编辑器中,按住 Control 键点按一个提交,然后从弹出式菜单中选取“Tag 'Your Identifier'”(标记“你的标识符”)。在出现的页面中,输入遵循语义版本控制标准的标签名称,如 1.2.4。你可以添加可选信息,然后点按“Create”(创建)。

公开提供你的 Swift 软件包

确保“Source Control Navigator”(源代码控制导航器) 处于可见状态,并且已选择本地储存库。右键点按,再选取“Create [packageName] Remote”(创建 [packageName] 远程储存库)。如果你已经为 Swift 软件包创建了空的远程储存库,可以选取“Add Existing Remote”(添加现有远程储存库)。

接下来,将你的本地更改和版本标签推送到 Git 远程储存库。点按“Source Control”(源代码控制) 菜单,选择“Push”(推送),从下拉菜单中选取对应的分支,再选中“Include Tags”(包括标签) 旁边的复选框,然后点按“Push”(推送)。

确保你的 Git 储存库是公开的,并让大家知道存在该软件包。其他开发者只需要该软件包的 Git URL,就能开始使用它。

要进一步了解如何利用软件包依赖项,请参阅“为你的 App 添加软件包依赖项”。