使用 EAS 工作流程为拉取请求创建预览构建

添加一个 preview.yml

🌐 Add a preview.yml

在 .eas/workflows/ 里，我们来添加一个叫 preview.yml 的新文件。这个工作流程文件使用了 preview 配置文件。

🌐 Inside .eas/workflows/, let's add a new file called preview.yml. This workflow file uses the preview profile.

name: Preview builds

jobs:
  fingerprint:
    name: Fingerprint
    type: fingerprint
    environment: preview
  get_android_build:
    name: Check for existing Android build
    needs: [fingerprint]
    type: get-build
    params:
      fingerprint_hash: ${{ needs.fingerprint.outputs.android_fingerprint_hash }}
      profile: preview
  get_ios_build:
    name: Check for existing iOS build
    needs: [fingerprint]
    type: get-build
    params:
      fingerprint_hash: ${{ needs.fingerprint.outputs.ios_fingerprint_hash }}
      profile: preview
  build_android:
    name: Build Android
    needs: [get_android_build]
    if: ${{ !needs.get_android_build.outputs.build_id }}
    type: build
    params:
      platform: android
      profile: preview
  build_ios:
    name: Build iOS
    needs: [get_ios_build]
    if: ${{ !needs.get_ios_build.outputs.build_id }}
    type: build
    params:
      platform: ios
      profile: preview

运行工作流

🌐 Run the workflow

使用以下命令手动运行工作流：

🌐 Run the workflow manually using the following command:

在 EAS 仪表板中，你会注意到工作流程遵循我们为开发构建实现的相同指纹模式。由于这是我们第一次创建预览构建，它会运行 Android 和 iOS 的构建任务。如果我们向 main 分支推送另一次提交而不更改原生代码，工作流程会跳过构建任务，因为已有兼容的构建存在。

🌐 In the EAS dashboard, notice that the workflow follows the same fingerprint pattern we implemented for development builds. Since we are creating the preview build for the first time, it runs the build jobs for Android and iOS. If we push another commit to the main branch without changing native code, the workflow skips the build jobs since compatible builds already exist.

创建一个 Slack webhook 链接

🌐 Create a Slack webhook URL

要从 EAS 工作流程向我们的 Slack 通道发送消息，我们需要从 Slack 设置中获取一个 webhook URL：

🌐 To send messages from EAS Workflows to our Slack channel, we need a webhook URL from Slack's settings:

1. 去 api.slack.com/apps 创建一个新的 Slack 应用（或者用现有的）。
2. 在 功能 下，选择 传入 Webhook 并将其打开。
3. 点击 添加新 Webhook 并选择要发布通知的通道。
4. 复制 webhook URL。它看起来像：https://hooks.slack.com/services/TD000/B000/XXXXXXXXXX
5. 将 webhook URL 添加为名为 SLACK_WEBHOOK_URL 的 EAS 环境变量。在我们项目的 EAS 仪表板的环境变量页面上，为 preview 环境创建该变量，并将其可见性设置为私密，因为只有 EAS 服务器需要读取它。或者，也可以通过 EAS CLI 创建：

添加一个 Slack 通知任务

🌐 Add a Slack notification job

让我们更新 preview.yml，在构建任务之后添加一个 notify 任务。notify 任务使用 webhook_url 和 message 参数，或者使用 payload 参数来通过 Slack Block Kit 进行丰富的格式化。该任务通过它的 environment 字段从 SLACK_WEBHOOK_URL 环境变量，我们之前创建的 中读取 webhook URL。任务默认在 production 环境中运行，所以在这里设置 environment: preview 就可以让变量生效。

🌐 Let's update preview.yml to add a notify job after the build jobs. The notify job uses webhook_url and message parameters, or a payload parameter for rich formatting with Slack Block Kit. The job reads the webhook URL from the SLACK_WEBHOOK_URL environment variable we created earlier through its environment field. Jobs default to the production environment, so setting environment: preview here is what makes the variable available.

name: Preview builds

jobs:
  fingerprint: # ...
  get_android_build: # ...
  get_ios_build: # ...
  build_android: # ...
  build_ios: # ...
  notify:
    name: Notify on Slack
    after: [build_android, build_ios]
    type: slack
    environment: preview
    params:
      webhook_url: ${{ env.SLACK_WEBHOOK_URL }}
      message: 'Preview builds are ready - Android: ${{ after.build_android.status }}, iOS: ${{ after.build_ios.status }}'

after 字段确保通知在构建完成后触发，无论结果如何。message 使用 ${{ after.build_android.status }} 和 ${{ after.build_ios.status }} 来包含每个平台的结果（成功、失败或跳过）。团队可以在不离开 Slack 的情况下看到发生了什么。

🌐 The after field ensures the notification fires once the builds finish, regardless of the outcome. The message uses ${{ after.build_android.status }} and ${{ after.build_ios.status }} to include each platform's outcome (success, failure, or skipped). The team sees what happened without leaving Slack.

运行工作流

🌐 Run the workflow

使用以下命令手动运行工作流：

🌐 Run the workflow manually using the following command:

在 EAS 仪表板上，我们可以确认 Notify on Slack 任务运行成功。

🌐 On the EAS dashboard, we can verify that the Notify on Slack job runs successfully.

我们也可以在与应用集成的 Slack 通道里验证这个。

🌐 We can also verify this in the Slack channel integrated with the app.

创建一个 pr-preview.yml

🌐 Create a pr-preview.yml

在 .eas/workflows/ 里面，我们来添加一个新文件，叫做 pr-preview.yml。这个工作流会在创建拉取请求时使用 on.pull_request 触发器运行。它只会使用 update 作业类型发布一个更新，然后在 PR 上发布一条带有更新链接的评论。

🌐 Inside .eas/workflows/, let's add a new file called pr-preview.yml. This workflow runs when a pull request is created using the on.pull_request trigger. It only publishes an update using the update job type and then posts a comment on the PR with the link to the update.

name: PR Preview

on:
  pull_request:
    branches: ['*']

jobs:
  publish_preview:
    name: Publish PR preview update
    type: update
    environment: preview
    params:
      channel: preview
  comment:
    needs: [publish_preview]
    type: github-comment

重要 在测试上述工作流程之前，先提交 pr-preview.yml 并将其推送到我们 GitHub 仓库的 main 分支。EAS 工作流程会从默认分支读取工作流程文件。

用拉取请求测试

🌐 Test with a pull request

让我们通过在我们的 GitHub 仓库中创建一个拉取请求来测试工作流程。拉取请求需要一个与 main 不同的分支。运行以下命令来创建并切换到一个新分支：

🌐 Let's test the workflow by creating a pull request in our GitHub repository. A pull request requires a separate branch from main. Run the following command to create and switch to a new branch:

现在，让我们在 Expo 项目中做一个可见的更改（例如，修改文本字符串或背景颜色）。然后，提交并推送分支：

🌐 Now, let's make a visible change in the Expo project (for example, change a text string or background color). Then, commit and push the branch:

在 GitHub 上从 test-preview 打开一个到 main 的拉取请求。创建拉取请求后，工作流会自动运行。在 EAS 仪表板上，我们可以看到 publish_preview 任务先运行，comment 任务在它成功后运行。

🌐 Open a pull request from test-preview to main on GitHub. The workflow runs automatically after we have created a pull request. On the EAS dashboard, we can verify that the publish_preview job runs first and the comment job runs after it succeeds.

在 GitHub 的 pull request 上，应该会出现一条评论，里面有一个链接或二维码，可以用来在设备上测试更新。

🌐 On the GitHub pull request, a comment should appear with a link or QR code to test the update on a device.

通过评论中的链接或二维码，我们现在可以在设备或模拟器/模拟器上打开更新并测试更改。

🌐 Using the link or QR code in the comment, we can now open the update on our device or emulator/simulator and test the changes.