Xcode Cloud 使用指南

一早就想写篇介绍 Xoode Cloud 的文章的，相关截图都准备好了，但迟迟没有动笔，现在看到了 Darryl Bayliss 的 Getting Setup With Xcode Cloud 一文，好了我不用写了，那我就把这篇文章翻译一下好了。

我现在正在使用 macOS Sequoia Beta 和 Xcode 16 Beta，也正是因为我可以使用 Xcode Cloud 来发布应用，所以我才敢大胆地使用 Beta 版系统。
下面是完整译文，本译文使用到了 AI 翻译，但个人精校。

Xcode Cloud 入门

Xcode Cloud 是 Apple 提供的一个持续集成和持续交付（Continuous Integration 和 Continuous Delivery，简称 CI/CD）平台。它能够自动化处理一些繁琐的工作流程，如构建应用、测试、签名以及分发。

你可能会问，为什么要使用 Xcode Cloud？如果你曾经手动将应用归档，然后提交到 App Store Connect，你就会知道这些步骤非常耗时。

有了 Xcode Cloud，你只需在 Xcode 中点击几下按钮，就可以轻松实现自动化。让我们来看看如何操作。

设置 Xcode Cloud

要使用 Xcode Cloud，有一些前提条件，主要包括：

加入 Apple 开发者计划
在 App Store Connect 上创建一个应用
将你的开发者 Apple ID 添加到 Xcode 中

你的项目还需要存储在一个 git 仓库中。Xcode Cloud 大量使用 git 作为触发器，以便知道何时开始运行。

如果你需要更多详细信息，可以查阅完整的要求列表。

一旦设置完成，就可以开始设置工作流了。在 Xcode 顶部，点击 Git 分支，会弹出一个窗口。你会看到一个名为 创建工作流 的选项。

点击该选项后，Xcode 会显示一个新窗口，询问你要为哪个应用创建工作流。

选择一个应用并点击 Next。接下来，你将进入一个新的界面，来自定义你的工作流。

创建工作流程

工作流界面包含几个不同的部分。首先是 General 部分，在这里你可以填写关于工作流的信息。

在这里，你可以为你的工作流命名，并描述它的功能。无论你是独立开发者，还是团队中有多个工程师需要使用同一工作流，这对你来说都是很有用的。

你还可以在这一部分中限制工作流的编辑权限，确保其他团队成员在没有适当权限的情况下不会篡改工作流。

接下来是 Environment 部分。在这里，你可以选择你的工作流将使用的 Xcode 和 macOS 的版本。

Xcode Cloud 提供了多种 Xcode 版本，包括测试版。这对于你想创建多个工作流来构建和测试不同配置时非常有用。

在 Environment 部分，你还可以选择在每次构建前清理工作流。如果不勾选该选项，每个工作流都会存储派生数据和每次构建的其他信息，以加快后续的构建速度。

虽然这通常是有益的，但根据你的需求，你可能希望避免这种情况。例如，将构建版本交付给 TestFlight 进行外部测试时，需要一个干净的构建。

最后，你可以为工作流设置环境变量。应用程序使用的自定义构建脚本可以获取这些变量，以扩展工作流。如果变量值需要保密，你可以勾选“Secret”选项框，变量值将被隐藏。

在设置完工作流信息并配置环境后，下一步就是创建触发器，这些触发器将使工作流运行。

启动条件

接下来的部分叫做 Start Conditions。在这里，你可以告诉工作流哪些条件应当触发它运行。默认情况下，Xcode 会将启动条件设置为对任何分支上的任何文件的任何更改。

建议根据需要调整这个设置，因为默认情况下，每次提交都会触发工作流运行。一个可选的方法是将启动条件限制为仅在特定分支上运行。首先，选择 Custom Branches 单选按钮，然后开始输入分支的名称。Xcode 会搜索你的 git 分支，并建议与你的搜索匹配的分支。

你还可以选择基于对特定文件或文件夹的更改来触发工作流，包括特定类型的文件。可以添加多个文件触发器，这样你就能为文件更改构建复杂的触发规则。

如果你需要不同的触发器，可以点击启动条件旁边的“+”按钮来创建不同的启动触发器。Xcode 为多种情况提供了不同的触发器。

这些触发器包括 git 标签的更改、Pull Request 的更改、特定分支的定时器，最后还有手动启动工作流。

大多数触发器都有一个常见的选项，就是 Auto Cancel Builds。如果你的触发器可能会多次启动工作流，这个功能非常有用。与其等待每个构建完成，Xcode Cloud 会取消较旧的构建并优先处理最新的构建。

这个功能非常实用，所以默认是启用的！

当你对工作流启动触发器感到满意时，你就可以继续设置工作流要执行的操作了。

工作流动作

在任何优秀的 CI/CD 平台中，定期和重复地执行动作是确保应用成功构建并快速发现问题的良好实践。

Xcode Cloud 也不例外，它允许你从一系列动作中进行选择。默认情况下，你的工作流包括一个 Build 动作，用于构建你选择的 app scheme。

如果 scheme 存在问题，Xcode Cloud 会提供有用的警告，以便你进行处理。

与启动触发器类似，你可以添加更多的构建动作作为工作流的一部分。这些操作包括运行测试、运行分析器，以及在将应用分发到 TestFlight 或 App Store 之前对其进行归档。

测试和分析构建操作包含一个 Requirement 设置。该设置决定构建操作是否必须通过才能让工作流继续。例如，如果你希望在某个测试失败时使工作流失败，那么你可以强制执行此要求。

有趣的是，目前测试构建操作似乎不支持 visionOS。

你可以根据需要为工作流配置任意数量的构建操作。例如，你可以为项目中的每个方案运行测试，然后在一个工作流中构建、归档和分发每个应用。

当你设置好构建动作后，就可以进入工作流的最后部分，设置后续动作。

后续动作

后续动作允许你在工作流完成之前执行一些操作。这些操作包括向 TestFlight 用户分发新构建版本，对 macOS 应用进行公证，以及通过 Slack 或电子邮件通知其他人工作流的结果。

Notify 动作让你可以在一定程度上控制发送的消息内容。你可以选择接收所有 Build Success 消息，或者在工作流从之前的失败中修复时收到通知，甚至可以选择不接收任何通知！

对于 Build Failure 消息，也有类似的选项。你可以选择接收所有失败消息、仅接收中断工作流的失败消息，或者完全不接收失败消息。

保存工作流

当设置好工作流后，点击窗口右下角的 Save 按钮。

Xcode Cloud 会检查工作流，并让你知道是否存在需要解决的问题。如果一切正常，工作流窗口会消失，你会回到 Xcode 界面。

再次点击 Xcode 顶部的 git 分支，这次选择 Manage Workflows。会出现一个新窗口，显示你为应用创建的工作流。

如果你想编辑工作流，选择该工作流并点击左下角的齿轮按钮。你也可以在选中工作流时点击 - 按钮来删除它。

在 Xcode Cloud 中运行 Shell 脚本

Xcode Cloud 支持在工作流的特定部分运行 Shell 脚本。如果你需要为工作流进行更高级的配置，这将非常有用，并且可以让你的工作流进一步自定义。

探讨这一主题超出了本文的范围，不过你可以在开发者文档中找到更多信息。

在 Xcode 和 App Store Connect 中查看你的工作流

你可以在 Xcode 中查看工作流的结果，方法是点击 Report Navigator，然后点击 Cloud 选项卡。每个工作流及其构建结果都会显示在这里。

你还可以在 App Store Connect 中查看和操作你的工作流，方法是导航到你的 App Store 列表，并在列表顶部选择 Xcode Cloud 选项卡。

费用

Xcode Cloud 包含在每个 Apple Developer Program 会员资格中。每个会员每月提供 25 小时的计算时间。如果超出这个时间，你可以选择多种订阅选项来获得更多的时间。

最后

如果你喜欢这篇博客文章，可以在 Kofi 上给我捐助。

你也可以点击下方的链接，在社交媒体上关注我，了解更多关于软件工程的内容。

以上就是原文全部内容了，Xcode Cloud 作为苹果官方的 CI/CD 工具，使用简单，25 小时的免费额度不多，但对于我来说，用于构建个人应用，还算够用。