跳至内容

GitHub Actions

仅限邀请

Tuist Runners 目前仅限邀请使用。联系我们或在社区 Slack中留言,为你的账户申请访问权限。

在集群上运行作业需要进行三项更改:连接 GitHub、将 runs-on 指向 Tuist 配置文件,然后推送代码。

  1. 连接 GitHub。 确保你的项目已连接到你的 GitHub 组织。Tuist 会接收该组织的 workflow_job 事件,并将匹配的作业分派到集群。如果没有此连接,作业将无法到达你的运行器。

  2. 将 runs-on 指向 Tuist 配置文件。 每个启用的账户都默认提供两个即开即用的配置文件:linux 和 macos。使用 tuist- 前缀来引用它们:

    yaml
    jobs:
    build:
    runs-on: tuist-macos # or tuist-linux
    steps:
    - uses: actions/checkout@v4
    - run: tuist test
    通过运行器配置文件选择 Xcode

    macOS 运行器镜像包含单个 Xcode 版本,Tuist 会在作业开始前根据配置文件进行选择。如果你正在从 GitHub 托管的运行器迁移,请移除使用 xcode-select --switch(或 xcode-select -s)或其他工具和 Action 来切换 Xcode 版本的步骤。这些步骤通常引用特定于 GitHub 托管镜像的 Xcode 安装路径,在 Tuist Runners 上可能会失败。

    要使用其他 Xcode 版本,请创建或选择一个包含该版本的配置文件并更新 runs-on,例如 runs-on: tuist-xcode-26-4。xcodebuild、xcrun 和 swift 随后将使用配置文件所选的 Xcode,无需在工作流中进行额外设置。

  3. 推送并观察。 作业会被加入队列,由运行器领取,并实时流式传输回 Tuist 仪表板的Runners部分,你可以在那里跟踪其日志、步骤和机器指标。

缓存卷#

使用缓存卷在作业之间保留 Xcode、模块和 Gradle 缓存以及其他目录。在检出代码之后、在使用这些目录的命令之前添加它们。

为作业授予 id-token: write 权限,以便其缓存卷和缓存的检出内容在作业启动时立即挂载。如果没有此权限,运行器将等待 GitHub 报告其正在运行的作业,而 GitHub 延迟报告的作业将以空缓存启动。使用 OpenID Connect 登录 Tuist 的工作流已自动授予此权限。

yaml
permissions:
contents: read
id-token: write