EAS Workflows でプルリクエスト向けのプレビュービルドを作成する

preview.yml を追加する

.eas/workflows/ の中に preview.yml という新しいファイルを追加しましょう。このワークフローファイルでは preview プロファイルを使用します。

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

ワークフローを実行する

次のコマンドでワークフローを手動で実行します。

EAS ダッシュボードでは、このワークフローが開発ビルドで実装したものと同じフィンガープリントのパターンをたどっていることが分かります。プレビュービルドを作成するのは初めてなので、Android と iOS のビルドジョブが実行されます。ネイティブコードを変更せずに main ブランチへ別のコミットをプッシュした場合は、互換性のあるビルドがすでに存在するため、ワークフローはビルドジョブをスキップします。

Slack の Webhook URL を作成する

EAS Workflows から Slack のチャンネルにメッセージを送るには、Slack の設定から Webhook URL を取得する必要があります。

1. api.slack.com/apps にアクセスして、新しい Slack アプリを作成します（既存のものを使ってもかまいません）。
2. Features の下にある Incoming Webhooks を選択し、有効に切り替えます。
3. Add New Webhook をクリックし、通知を投稿するチャンネルを選択します。
4. Webhook URL をコピーします。https://hooks.slack.com/services/TD000/B000/XXXXXXXXXX のような形式です。
5. この Webhook URL を SLACK_WEBHOOK_URL という名前の EAS 環境変数として追加します。EAS ダッシュボードでプロジェクトの Environment variables ページを開き、preview 環境用の変数を作成して、可視性を secret に設定します。この値を読み取る必要があるのは EAS のサーバーだけだからです。EAS CLI で作成することもできます。

Slack 通知のジョブを追加する

preview.yml を更新して、ビルドジョブのあとに notify ジョブを追加しましょう。notify ジョブでは webhook_url と message のパラメーター、または Slack Block Kit でリッチな装飾を行うための payload パラメーターを使用します。このジョブは、environment フィールドを通じて先ほど作成した SLACK_WEBHOOK_URL 環境変数から Webhook URL を読み取ります。ジョブはデフォルトで production 環境を使うため、ここで environment: preview を指定することでこの変数が利用可能になります。

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 を離れずに状況を把握できます。

ワークフローを実行する

次のコマンドでワークフローを手動で実行します。

EAS ダッシュボードで、Notify on Slack ジョブが正常に実行されたことを確認できます。

アプリと連携している Slack のチャンネルでも確認できます。

pr-preview.yml を作成する

.eas/workflows/ の中に pr-preview.yml という新しいファイルを追加しましょう。このワークフローは on.pull_request トリガーによって、プルリクエストが作成されたときに実行されます。update ジョブタイプでアップデートを公開するだけの内容で、そのあとアップデートへのリンクを PR にコメントします。

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 Workflows はデフォルトブランチからワークフローファイルを読み取ります。

プルリクエストでテストする

GitHub リポジトリでプルリクエストを作成して、ワークフローをテストしてみましょう。プルリクエストには main とは別のブランチが必要です。次のコマンドを実行して、新しいブランチを作成して切り替えます。

続いて、Expo プロジェクトに目に見える変更（たとえばテキストや背景色の変更）を加えます。そのうえで、コミットしてブランチをプッシュします。

GitHub で test-preview から main へのプルリクエストを開きます。プルリクエストを作成すると、ワークフローが自動的に実行されます。EAS ダッシュボードでは、まず publish_preview ジョブが実行され、それが成功したあとに comment ジョブが実行されることを確認できます。

GitHub のプルリクエストには、デバイスでアップデートをテストするためのリンクまたは QR コードを含んだコメントが表示されるはずです。

コメント内のリンクや QR コードを使えば、デバイスやエミュレーター/シミュレーターでアップデートを開いて、変更をテストできます。