运行你的第一个 EAS Workflows 作业

创建工作流目录

在 Expo 项目根目录下创建 .eas/workflows/ 目录。EAS 只会在这个位置查找工作流文件。

添加 hello.yml 文件

在 .eas/workflows/ 内创建一个名为 hello.yml 的文件。此文件使用一个单独的自定义作业定义我们的第一个工作流。该作业运行一条 shell 命令，输出 "Hello, Workflows"：

name: Hello

jobs:
  greet:
    steps:
      - run: echo "Hello, Workflows" # 这里可以使用任何 shell 命令

上面的工作流使用以下语法：

• name 是工作流的名称，会显示在 EAS 仪表板上。
• jobs 包含一个或多个要运行的作业。每个作业都有一个唯一的 ID（在这里是 greet）。
• steps 是作业按顺序执行的一系列任务。只有 steps 但没有 type 字段的作业是自定义作业。
• run 是在某个步骤中要执行的 shell 命令。这里它运行 echo 来打印一条消息。任何 shell 命令都可以。

手动运行工作流

要在 EAS 仪表板上运行该工作流，请在终端窗口中运行以下命令：

eas workflow:run 命令会将工作流文件上传到 EAS。随后它会运行文件中定义的任何作业，EAS CLI 会打印一个指向 EAS 仪表板的 URL，我们可以在那里查看该作业。

查看作业日志

在浏览器窗口中打开上一步得到的 URL。在工作流页面上，我们可以看到 greet 作业及其状态。作业完成后，展开步骤输出即可看到记录的消息：Hello, Workflows。

EAS 仪表板是我们查看和调试任何工作流作业的地方。Workflow graph 会显示是什么触发了我们的作业，以及该作业的唯一 ID。

切换到 Workflow file 选项卡。这就是我们在第 2 步编写的工作流文件，会随这次运行一起保留。

提示： 在 Workflows 页面 上查看我们项目的所有工作流，并按状态或类型进行筛选。

添加自动触发器

让我们在现有的工作流文件中添加一个 on.push.branches 触发器。

• on 键定义哪个 GitHub 事件会触发工作流
• push 字段定义何时触发
• branches 字段允许我们指定：只要代码推送到 main 分支，工作流就应自动运行

name: Hello

on:
  push:
    branches: ['main'] # 每次推送到 main 分支时触发

jobs:
  greet:
    steps:
      - run: echo "Hello, Workflows"

branches 字段可以包含 GitHub 仓库中存在的任何分支名称。我们可以指定多个分支，例如 ['main', 'develop', 'staging']，以便在推送到这些分支中的任意一个时触发工作流。

提交更改并推送到 GitHub

提交工作流文件并将其推送到 main 分支：

验证自动触发器

提示： 此步骤依赖于我们的本地 Expo 项目已推送到 GitHub，并且 GitHub 仓库已连接到 EAS。确认方法：运行 git remote -v 检查本地仓库是否指向 GitHub URL，并打开项目的 EAS 上 GitHub 设置 以确认已连接仓库。

让我们在 EAS 仪表板上打开项目的 Workflows 页面，查看新的任务。

在 EAS 仪表板中，注意 Workflow graph 选项卡会显示这次推送的提交信息和分支引用。在工作流标题下方的状态中，Trigger 和 Triggered by 也会反映相同的信息。

更新 hello.yml

让我们更新 hello.yml 文件，添加一个自定义作业和一个预打包作业。这个预打包作业叫做 doc，它会在 EAS 仪表板上渲染 Markdown：

name: Hello

jobs:
  greet:
    outputs:
      greeting: ${{ steps.set_greeting.outputs.greeting }} # 在作业级别暴露步骤输出
    steps:
      - id: set_greeting
        run: set-output greeting "Hello from EAS Workflows"
  show_info:
    needs: [greet] # 等待 greet 完成，然后读取其输出
    type: doc # 在仪表板上渲染 Markdown 的预打包作业
    params:
      md: |
        # Workflow Output
        **${{ needs.greet.outputs.greeting }}**

上面的工作流文件执行以下操作：

• 定义了一个 greet 作业，这是一个自定义作业。它使用 set-output shell 函数设置一个名为 greeting 的值。作业级别的 outputs 字段会暴露该步骤输出，以便其他作业引用它。
• 定义了一个 show_info 作业，它使用 needs: [greet] 等待 greet 作业完成并访问其输出。然后，它使用预打包的 doc 作业类型在 EAS 仪表板中渲染一个 Markdown 文档。Markdown 内容包含在前一个作业中设置的 greeting 值。

提示： 在 EAS Workflows 中，作业默认是并行运行的。needs 字段决定了一个作业必须等待什么：它列出在使用 needs 的作业启动之前必须成功完成的作业 ID。如果 needs 列表中的某个作业失败，依赖作业将被跳过。

运行串联的工作流

在终端窗口中运行以下命令，查看串联作业的实际效果：

从 EAS CLI 打开 EAS 仪表板链接。在 Logs 下，注意 greet 作业会先运行。完成后，show_info 作业会运行，并使用前一个作业的输出渲染 Markdown 内容。