运行你的第一个EAS工作流程任务

创建工作流目录

🌐 Create the workflow directory

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

🌐 Create the .eas/workflows/ directory at the root of our Expo project. EAS looks for workflow files only in this location.

添加一个 hello.yml 文件

🌐 Add a hello.yml file

在 .eas/workflows/ 里面，创建一个名为 hello.yml 的文件。这个文件使用一个自定义作业定义了我们的第一个工作流。这个作业运行一个打印 "Hello, Workflows" 的 shell 命令：

🌐 Inside .eas/workflows/, create a file named hello.yml. This file defines our first workflow using a single custom job. The job runs a shell command that prints "Hello, Workflows":

name: Hello

jobs:
  greet:
    steps:
      - run: echo "Hello, Workflows" # Any shell command works here

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

🌐 The above workflow uses the following syntax:

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

手动运行工作流

🌐 Manually run the workflow

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

🌐 To run the workflow on the EAS dashboard, run the following command from a terminal window:

eas workflow:run 命令会把工作流文件上传到 EAS。然后它会运行文件中定义的任何任务，EAS CLI 会打印一个 URL，带你去 EAS 仪表板观看任务的执行情况。

🌐 The eas workflow:run command uploads the workflow file to EAS. It then runs any job defined inside the file and the EAS CLI prints a URL to the EAS dashboard where we can watch the job.

查看作业日志

🌐 View the job logs

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

🌐 Open the URL from the previous step in a browser window. On the workflow page, we can see the greet job and its status. Once the job completes, expand the step output to see the logged message: Hello, Workflows.

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

🌐 The EAS dashboard is where we view and debug any workflow job. The Workflow graph shows what triggered our job and the job's unique ID.

切换到 Workflow file 标签。这就是我们在第2步写的工作流文件，它会随运行一起保存。

🌐 Switch to the Workflow file tab. This is the workflow file we wrote in Step 2, preserved with the run.

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

添加自动触发器

🌐 Add an automatic trigger

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

🌐 Let's add an on.push.branches trigger to our existing workflow file.

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

name: Hello

on:
  push:
    branches: ['main'] # Fires on every push to main branch

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

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

🌐 The branches field can include any branch name that exists in a GitHub repository. We can specify multiple branches such as ['main', 'develop', 'staging'] to trigger the workflow when we push to any of those branches.

提交更改并推送到 GitHub

🌐 Commit the change and push to GitHub

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

🌐 Commit the workflow file and push it to the main branch:

验证自动触发

🌐 Verify the automatic trigger

信息 小贴士： 这一步取决于我们的本地 Expo 项目已经推送到 GitHub，并且 GitHub 仓库已连接到 EAS。要确认：运行 git remote -v 以验证本地仓库是否指向 GitHub URL，并打开项目的 EAS 上的 GitHub 设置 检查是否已连接仓库。

让我们在 EAS 仪表板上打开我们项目的 工作流页面 来看看新的任务。

🌐 Let's open our project's Workflows page on the EAS dashboard to see the new job.

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

🌐 In the EAS dashboard, notice that the Workflow graph tab shows the commit message and branch reference for this push. In the status under the workflow header, the Trigger and Triggered by reflect the same information.

更新 hello.yml

🌐 Update hello.yml

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

🌐 Let's update the hello.yml file to add a custom job and a pre-packaged job. This pre-packaged job is called doc and it renders Markdown on the EAS dashboard:

name: Hello

jobs:
  greet:
    outputs:
      greeting: ${{ steps.set_greeting.outputs.greeting }} # Expose the step output at the job level
    steps:
      - id: set_greeting
        run: set-output greeting "Hello from EAS Workflows"
  show_info:
    needs: [greet] # Wait for greet to finish, then read its outputs
    type: doc # Pre-packaged job that renders Markdown on the dashboard
    params:
      md: |
        # Workflow Output
        **${{ needs.greet.outputs.greeting }}**

上面的工作流文件做了以下事情：

🌐 The above workflow file does the following:

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

信息 提示: 在 EAS 工作流中，默认情况下作业是并行运行的。needs 字段是让作业等待的关键：它列出了必须先成功完成的作业 ID，然后 needs 才能开始运行。如果 needs 列表中的某个作业失败，依赖的作业将被跳过。

运行链式工作流

🌐 Run the chained workflow

在终端窗口中运行以下命令来查看连锁作业的运行效果：

🌐 Run the following command from a terminal window to see the chained jobs in action:

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

🌐 Open the EAS dashboard link from the EAS CLI. Under Logs, notice that the greet job runs first. Once it completes, the show_info job runs and renders the Markdown content using the output from the previous job.