EAS 工作流语法

name: My workflow

name: Deploy
run_name: Deploy ${{ inputs.environment }}

on:
  workflow_dispatch:
    inputs:
      environment:
        type: choice
        options:
          - preview
          - production
        required: true

on:
  # Trigger on pushes to main branch
  push:
    branches:
      - main
  # And on pull requests starting with 'version-'
  pull_request:
    branches:
      - version-*

on:
  push:
    branches:
      - main
      - feature/**
      - !feature/test-** # other branch names and globs


    tags:
      - v1
      - v2*
      - !v2-preview** # other tag names and globs


    paths:
      - apps/mobile/**
      - packages/shared/**
      - !**/*.md # ignore markdown files

on:
  ref_delete:
    branches:
      - feat/**
      - !main # other branch names and globs


    tags:
      - v*
      - !v2-preview** # other tag names and globs

on:
  pull_request:
    branches:
      - main
      - feature/**
      - !feature/test-** # other branch names and globs


    types:
      - opened
      # other event types

    paths:
      - apps/mobile/**
      - packages/shared/**
      - !**/*.md # ignore markdown files

on:
  pull_request_labeled:
    labels:
      - Test
      - Preview
      # other labels

on:
  pull_request_labeled:
    - Test
    - Preview
    # other labels

on:
  pull_request_comment:
    types:
      - created
      - edited
      # other event types

# Triggers when:
# - the app version enters review,
# - a build upload completes or fails,
# - an external beta build is ready for testing or approved,
# - a tester reports a crash via TestFlight.
on:
  app_store_connect:
    app_version:
      states:
        - ready_for_review
        - waiting_for_review
    build_upload:
      states:
        - complete
        - failed
    external_beta:
      states:
        - ready_for_beta_testing
        - beta_approved
    beta_feedback:
      types:
        - crash

# Triggers on any app version or build upload state change.
on:
  app_store_connect:
    app_version: {}
    build_upload: {}

on:
  schedule:
    - cron: '0 0 * * *' # Runs at midnight GMT every day

on:
  workflow_dispatch:
    inputs:
      name:
        type: string
        required: false
        description: 'Name of the person to greet'
        default: 'World'
      choice_example:
        type: choice
        options:
          - to be
          - not to be
        required: true

on:
  workflow_dispatch:
    inputs:
      name:
        type: string
        required: true
        description: 'Name of the person to greet'

jobs:
  deploy:
    steps:
      - name: Deploy to environment
        run: |
          echo "Hello, ${{ inputs.name }}!"

          # Note: you can use `||` to provide a default value
          #       for non-eas-workflow:run-run workflows.
          echo "Hello, ${{ inputs.name || 'World' }}!"

on:
  pull_request:
    if: ${{ !github.event.pull_request.draft }}

on:
  push:
    if: ${{ github.ref_name == 'main' }}
  pull_request_comment:
    if: ${{ startsWith(github.event.comment.body, '/deploy') }}

jobs:
  job_1:
    # ...
  job_2:
    # ...

jobs:
  my_job:
    # ...

jobs:
  my_job:
    name: Build app

jobs:
  my_job:
    environment: production | preview | development

jobs:
  my_job:
    env:
      APP_VARIANT: staging
      RETRY_COUNT: 3
      PREV_JOB_OUTPUT: ${{ needs.previous_job.outputs.some_output }}

jobs:
  maestro_test:
    type: maestro-cloud
    params:
      build_id: ${{ needs.build.outputs.build_id }}
      maestro_project_id: proj_xyz
      flows: ./maestro/flows
    hooks:
      before_maestro_cloud:
        - run: echo "Before upload"
      after_maestro_cloud:
        - run: echo "After upload"

defaults:
  hooks:
    before_install_node_modules:
      - name: Configure private registry
        run: echo "//npm.pkg.github.com/:_authToken=$GITHUB_TOKEN" >> .npmrc

jobs:
  build_app:
    type: build
    params:
      platform: ios
  publish_update:
    type: update
    hooks:
      before_install_node_modules: [] # opt this job out of the default hook

defaults:
  image: sdk-57

concurrency:
  cancel_in_progress: true
  group: ${{ workflow.filename }}-${{ github.ref }}

jobs:
  test:
    steps:
      - uses: eas/checkout
      - uses: eas/use_npm_token
      - uses: eas/install_node_modules
      - name: tsc
        run: yarn tsc
  build:
    needs: [test] # This job will only run if the 'test' job succeeds
    type: build
    params:
      platform: ios

jobs:
  build:
    type: build
    params:
      platform: ios
  notify:
    after: [build] # This job will run after build completes (whether build succeeds or fails)

jobs:
  my_job:
    if: ${{ github.ref_name == 'main' }}

{
  "status": "success" | "failure" | "skipped",
  "outputs": {}
}

jobs:
  build:
    type: build
    params:
      platform: ios
  notify:
    after: [build]
    steps:
      - run: echo "Build status: ${{ after.build.status }}"

{
  "status": "success" | "failure" | "skipped",
  "outputs": {}
}

jobs:
  setup:
    outputs:
      date: ${{ steps.current_date.outputs.date }}
    steps:
      - id: current_date
        run: |
          DATE=$(date +"%Y.%-m.%-d")
          set-output date "$DATE"

  build_ios:
    needs: [setup]
    type: build
    env:
      # You might use process.env.VERSION_SUFFIX to customize
      # app version in your dynamic app config.
      VERSION_SUFFIX: ${{ needs.setup.outputs.date }}
    params:
      platform: ios
      profile: development

jobs:
  my_job:
    outputs:
      value: ${{ steps.step_1.outputs.value }}
    steps:
      - id: step_1
        run: set-output value "hello"
      - run: echo ${{ steps.step_1.outputs.value }}

  another_job:
    needs: [my_job]
    steps:
      - run: echo "Value: ${{ needs.my_job.outputs.value }}"

on:
  workflow_dispatch:
    inputs:
      name:
        type: string
        required: true

jobs:
  greet:
    steps:
      - run: echo "Hello, ${{ inputs.name }}!"

type GitHubContext = {
  triggering_actor?: string;
  event_name: 'pull_request' | 'push' | 'schedule' | 'workflow_dispatch';
  sha: string;
  ref: string; // e.g. refs/heads/main
  ref_name: string; // e.g. main
  ref_type: 'branch' | 'tag' | 'other';
  commit_message?: string; // Only available for push and schedule events
  label?: string;
  repository?: string;
  repository_owner?: string;
  event?: {
    action?: string;
    label?: {
      name: string;
    };
    // Only available for push and schedule events
    head_commit?: {
      message: string;
      id: string;
    };
    pull_request?: {
      number: number;
      title: string;
      body: string | null;
      state: 'open' | 'closed';
      draft: boolean;
      merged: boolean | null;
      // ... Other fields from the GitHub Pull Request webhook payload
    };
    comment?: {
      body: string;
      // ... Other fields from the GitHub issue_comment webhook payload
    };
    changes?: {
      base?: {
        ref?: {
          from: string;
        };
      };
    };
    number?: number;
    schedule?: string;
    inputs?: Record<string, string | number | boolean>;
  };
};

jobs:
  build_ios:
    type: build
    if: ${{ github.ref_name == 'main' }}
    params:
      platform: ios
      profile: production

type WorkflowContext = {
  id: string;
  name: string;
  filename: string;
  url: string;
};

jobs:
  notify_slack:
    after: [...]
    type: slack
    params:
      message: |
        Workflow run completed: ${{ workflow.name }}
        View details: ${{ workflow.url }}

type AppContext = {
  id: string;
  slug: string;
};

jobs:
  print_context:
    steps:
      - run: echo "Project ${{ app.slug }} (${{ app.id }})"

type AccountContext = {
  id: string;
  name: string;
};

jobs:
  print_context:
    steps:
      - run: echo "Account ${{ account.name }} (${{ account.id }})"

type AppStoreConnectContext = {
  app: {
    id: string;
  };
  build_upload?: {
    id: string;
    state: 'awaiting_upload' | 'processing' | 'failed' | 'complete';
    cf_bundle_version?: string;
    cf_bundle_short_version_string?: string;
    platform?: string;
    uploaded_date?: string;
    created_date?: string;
    build?: {
      id: string;
    };
  };
  app_version?: {
    id: string;
    state: string;
  };
  external_beta?: {
    id: string;
    state: string;
  };
  beta_feedback?: {
    id: string;
    type: 'crash' | 'screenshot';
    url: string;
  };
};

on:
  app_store_connect:
    build_upload:
      states:
        - complete

jobs:
  notify:
    type: slack
    params:
      webhook_url: ${{ env.SLACK_WEBHOOK_URL }}
      message: |
        Upload complete for App Store Connect app: ${{ app_store_connect.app.id }}
        Upload ID: ${{ app_store_connect.build_upload.id }}
        Upload state: ${{ app_store_connect.build_upload.state }}
        Version: ${{ app_store_connect.build_upload.cf_bundle_short_version_string }} (${{ app_store_connect.build_upload.cf_bundle_version }})

jobs:
  my_job:
    steps:
      - run: echo "API URL: ${{ env.API_URL }}"

jobs:
  notify:
    if: ${{ success() }}
    steps:
      - run: echo "All jobs succeeded"

jobs:
  notify:
    if: ${{ failure() }}
    steps:
      - run: echo "A job failed"

jobs:
  publish_update:
    type: update

  print_debug_info:
    needs: [publish_update]
    steps:
      - run: |
          echo "First update group: ${{ needs.publish_update.outputs.first_update_group_id }}"
          echo "Second update group: ${{ fromJSON(needs.publish_update.outputs.updates_json || '[]')[1].group }}"

jobs:
  my_job:
    steps:
      - run: echo '${{ toJSON(github.event) }}'

jobs:
  my_job:
    if: ${{ contains(github.ref_name, 'feature') }}
    steps:
      - run: echo "Feature branch"

jobs:
  my_job:
    if: ${{ startsWith(github.ref_name, 'release') }}
    steps:
      - run: echo "Release branch"

jobs:
  my_job:
    if: ${{ endsWith(github.ref_name, '-production') }}
    steps:
      - run: echo "Production branch"

jobs:
  my_job:
    steps:
      - run: echo "Dependencies hash: ${{ hashFiles('package-lock.json', 'yarn.lock') }}"

jobs:
  my_job:
    steps:
      - run: echo "${{ replaceAll(github.ref_name, '/', '-') }}"

jobs:
  my_job:
    steps:
      - run: echo "${{ substring(github.ref_name, 0, 50) }}"

jobs:
  my_job:
    type: build

jobs:
  my_job:
    type: build
    params:
      platform: ios | android # required
      profile: string # optional, default: production
      message: string # optional
      refresh_ad_hoc_provisioning_profile: boolean # optional
    hooks:
      before_install_node_modules: step[] # optional
      after_install_node_modules: step[] # optional

{
  "build_id": string,
  "app_build_version": string | null,
  "app_identifier": string | null,
  "app_version": string | null,
  "channel": string | null,
  "distribution": "internal" | "store" | null,
  "fingerprint_hash": string | null,
  "git_commit_hash": string | null,
  "platform": "ios" | "android" | null,
  "profile": string | null,
  "runtime_version": string | null,
  "sdk_version": string | null,
  "simulator": "true" | "false" | null
}

jobs:
  my_job:
    type: deploy
    params:
      alias: string # optional
      prod: boolean # optional
      source_maps: boolean # optional
    hooks:
      after_checkout: step[] # optional
      before_install_node_modules: step[] # optional
      after_install_node_modules: step[] # optional

{
  "deploy_json": string, // JSON object containing the deployment details (output of `npx eas-cli deploy --json`).
  "deploy_url": string, // URL to the deployment. It uses production URL if this was a production deployment. Otherwise, it uses the first alias URL or the deployment URL.
  "deploy_alias_url": string, // Alias URL to the deployment (for example, `https://account-project--alias.expo.app`).
  "deploy_deployment_url": string, // Unique URL to the deployment (for example, `https://account-project--uniqueid.expo.app`).
  "deploy_identifier": string, // Identifier of the deployment.
  "deploy_dashboard_url": string, // URL to the deployment dashboard (for example, `https://expo.dev/projects/[project]/hosting/deployments`).
}

jobs:
  my_job:
    type: fingerprint
    environment: production # Should match your build profile
    hooks:
      after_checkout: step[] # optional
      before_install_node_modules: step[] # optional
      after_install_node_modules: step[] # optional

{
  "android_fingerprint_hash": string,
  "ios_fingerprint_hash": string,
}

jobs:
  my_job:
    type: get-build
    params:
      platform: ios | android # optional
      profile: string # optional
      distribution: store | internal | simulator # optional
      channel: string # optional
      app_identifier: string # optional
      app_build_version: string # optional
      app_version: string # optional
      git_commit_hash: string # optional
      fingerprint_hash: string # optional
      sdk_version: string # optional
      runtime_version: string # optional
      simulator: boolean # optional
      wait_for_in_progress: boolean # optional

{
  "build_id": string,
  "app_build_version": string | null,
  "app_identifier": string | null,
  "app_version": string | null,
  "channel": string | null,
  "distribution": "internal" | "store" | null,
  "fingerprint_hash": string | null,
  "git_commit_hash": string | null,
  "platform": "ios" | "android" | null,
  "profile": string | null,
  "runtime_version": string | null,
  "sdk_version": string | null,
  "simulator": "true" | "false" | null
}

jobs:
  my_job:
    type: submit
    params:
      build_id: string # required
      profile: string # optional, default: production
      groups: string[] # optional
    hooks:
      after_checkout: step[] # optional
      before_install_node_modules: step[] # optional
      after_install_node_modules: step[] # optional
      before_submit: step[] # optional
      after_submit: step[] # optional

{
  "apple_app_id": string | null, // Apple App ID. https://expo.fyi/asc-app-id
  "ios_bundle_identifier": string | null, // iOS bundle identifier of the submitted build. https://expo.fyi/bundle-identifier
  "android_package_id": string | null // Submitted Android package ID. https://expo.fyi/android-package
}

jobs:
  my_job:
    type: testflight
    params:
      build_id: string # required to upload and submit to TestFlight; mutually exclusive with asc_build_id
      profile: string # optional, default: production; only when uploading and submitting
      wait_processing_timeout_seconds: number # optional, default: 1800 (30 minutes); only when uploading and submitting in one job
      asc_build_id: string # required to submit an already uploaded build; mutually exclusive with build_id
      internal_groups: string[] # optional
      external_groups: string[] # optional
      changelog: string # optional
      submit_beta_review: boolean # optional
    hooks: # only when uploading and submitting with build_id
      after_checkout: step[] # optional
      before_install_node_modules: step[] # optional
      after_install_node_modules: step[] # optional

{
  "apple_app_id": string | null, // Apple App ID. https://expo.fyi/asc-app-id
  "ios_bundle_identifier": string | null, // iOS bundle identifier of the submitted build. https://expo.fyi/bundle-identifier
  "asc_build_id": string | null // App Store Connect build ID. Only when submitting an already uploaded build.
}

jobs:
  my_job:
    type: update
    params:
      message: string # optional
      platform: string # optional - android | ios | all, defaults to all
      branch: string # optional
      channel: string # optional - cannot be used with branch
      rollout_percentage: number # optional - 0 to 100, defaults to 100
      private_key_path: string # optional
      upload_sentry_sourcemaps: boolean # optional - defaults to "try uploading, but don't fail the job if it fails"
    hooks:
      after_checkout: step[] # optional
      before_install_node_modules: step[] # optional
      after_install_node_modules: step[] # optional
      before_update: step[] # optional
      after_update: step[] # optional

{
  "first_update_group_id": string, // ID of the first update group. You can use it to e.g. construct the update URL for a development client deep link.
  "updates_json": string // Stringified JSON array of update groups. Output of `eas update --json`.
}

jobs:
  my_job:
    type: update-rollout
    params:
      update_group_id: string # required
      rollout_percentage: number # optional - 0 to 100, defaults to 100

{
  "update_group_id": string, // ID of the update group that was rolled out.
  "rollout_percentage": string, // The rollout percentage that was applied to the update group.
  "updates_json": string // Stringified JSON array of the updates in the group.
}

jobs:
  my_job:
    type: branch-delete
    params:
      branch_name: string # required
      fail_on_missing: boolean # optional, default: false

{
  "branch_id": string | null,
  "branch_name": string
}

jobs:
  my_job:
    type: maestro
    environment: production | preview | development # optional, defaults to preview
    image: string # optional. See https://docs.expo.dev/build-reference/infrastructure/ for a list of available images.
    runs_on: string # optional. Use a linux-*-nested-virtualization worker for Android Emulator tests. See https://docs.expo.dev/eas/workflows/syntax/#jobsjob_idruns_on for available options.
    params:
      build_id: string # required
      flow_path: string | string[] # required
      shards: number # optional, defaults to 1
      retries: number # optional, defaults to 0
      retry_failed_only: boolean # optional, defaults to true. When true, retries will attempt to re-run only the flows that failed on the previous attempt when applicable.
      record_screen: boolean # optional, defaults to false. If true, uploads a screen recording of the tests.
      include_tags: string | string[] # optional. Tags to include in the tests. Will be passed to Maestro as `--include-tags`.
      exclude_tags: string | string[] # optional. Tags to exclude from the tests. Will be passed to Maestro as `--exclude-tags`.
      maestro_version: string # optional. Version of Maestro to use for the tests. If not provided, the latest version will be used.
      android_system_image_package: string # optional. Android Emulator system image package to use.
      device_identifier: string | { android?: string, ios?: string } # optional. Device identifier to use for the tests.
      output_format: string # optional, defaults to junit. Maestro test report format. Will be passed to Maestro as `--format`. Can be `junit` or other supported formats.
      skip_build_check: boolean # optional, defaults to false. Skip validation of the build (whether an iOS build is a simulator build).
    hooks:
      after_checkout: step[] # optional
      before_maestro_tests: step[] # optional
      after_maestro_tests: step[] # optional

jobs:
  my_job:
    type: maestro-cloud
    environment: production | preview | development # optional, defaults to preview
    image: string # optional. See https://docs.expo.dev/build-reference/infrastructure/ for a list of available images.
    params:
      build_id: string # required. ID of the build to test.
      maestro_project_id: string # required. Maestro Cloud project ID. Example: `proj_01jw6hxgmdffrbye9fqn0pyzm0`.
      flows: string # required. Path to the Maestro flow file or directory containing the flows to run. Corresponds to `--flows` param to `maestro cloud`.
      maestro_api_key: string # optional. The API key to use for the Maestro project. By default, `MAESTRO_CLOUD_API_KEY` environment variable will be used. Corresponds to `--api-key` param to `maestro cloud`.
      include_tags: string | string[] # optional. Tags to include in the tests. Will be passed to Maestro as `--include-tags`.
      exclude_tags: string | string[] # optional. Tags to exclude from the tests. Will be passed to Maestro as `--exclude-tags`.
      maestro_version: string # optional. Version of Maestro to use for the tests. If not provided, the latest version will be used.
      maestro_config: string # optional. Path to the Maestro `config.yaml` file to use for the tests. Will be passed to Maestro as `--config`.
      device_locale: string # optional. Device locale to use for the tests. Will be passed to Maestro as `--device-locale`.
      device_model: string # optional. Model of the device to use for the tests. Will be passed to Maestro as `--device-model`. Run `maestro list-cloud-devices` for a list of supported values.
      device_os: string # optional. OS of the device to use for the tests. Will be passed to Maestro as `--device-os`. Run `maestro list-cloud-devices` for a list of supported values.
      skip_build_check: boolean # optional, defaults to false. Skip validation of the build (whether an iOS build is a simulator build).
      name: string # optional. Name for the Maestro Cloud upload. Corresponds to `--name` param to `maestro cloud`.
      branch: string # optional. Override for the branch the Maestro Cloud upload originated from. By default, if the workflow run has been triggered from GitHub, the branch of the workflow run will be used. Corresponds to `--branch` param to `maestro cloud`.
      async: boolean # optional. Run the Maestro Cloud tests asynchronously. If true, the status of the job will only denote whether the upload was successful, *not* whether the tests succeeded. Corresponds to `--async` param to `maestro cloud`.
    hooks:
      after_checkout: step[] # optional. Steps to run after the job checks out your project.
      before_maestro_cloud: step[] # optional. Steps to run before the Maestro Cloud upload.
      after_maestro_cloud: step[] # optional. Steps to run after the Maestro Cloud upload.

jobs:
  my_job:
    type: slack
    params:
      webhook_url: string # required
      message: string # required if payload is not provided
      payload: object # required if message is not provided

jobs:
  my_job:
    type: github-comment
    params:
      message: string # optional - custom message to include in the report
      build_ids: string[] # optional - specific build IDs to include, defaults to all related to the running workflow
      update_group_ids: string[] # optional - specific update group IDs to include, defaults to all related to the workflow
      deployment_ids: string[] # optional - specific deployment IDs to include, defaults to all related to the workflow

  # instead of using message and the builds, updates, and deployments table, you can also override the comment contents with `payload`
  custom_github_comment:
    type: github-comment
    params:
      payload: string # optional - raw markdown/HTML content for fully custom comment

{
  "comment_url": string | undefined  // URL of the posted GitHub comment
}

jobs:
  register_device:
    type: apple-device-registration-request
    params:
      apple_team_identifier: string # optional

jobs:
  confirm:
    type: require-approval

jobs:
  next_steps:
    type: doc
    params:
      md: string

jobs:
  next_steps:
    type: repack
    params:
      build_id: string # required
      profile: string # optional
      embed_bundle_assets: boolean # optional
      js_bundle_only: boolean # optional
      ios_signing_use_source_app_entitlements: boolean # optional
      ios_signing_app_entitlements_path: string # optional
      message: string # optional
      repack_version: string # optional
      repack_package: string # optional
    hooks:
      after_checkout: step[] # optional
      before_install_node_modules: step[] # optional
      after_install_node_modules: step[] # optional

jobs:
  my_job:
    steps:
      # ...

jobs:
  my_job:
    steps:
      - name: My first step
        run: echo "Hello World"

jobs:
  job_1:
    outputs:
      output_1: ${{ steps.step_1.outputs.test }}
    steps:
      - id: step_1
        run: set-output test "hello world"
  job_2:
    needs: [job_1]
    steps:
      - id: step_2
        run: echo ${{ needs.job_1.outputs.output_1 }}

jobs:
  my_job:
    image: auto | string # optional, defaults to 'auto'

jobs:
  my_job:
    runs_on: linux-medium | linux-large |
      linux-medium-nested-virtualization |
      linux-large-nested-virtualization |
      macos-medium | macos-large # optional, defaults to linux-medium

jobs:
  my_job:
    outputs:
      test: ${{ steps.step_1.outputs.test }} # 引用 step_1 的输出
    steps:
      - id: step_1
        run: set-output test "hello world"

jobs:
  my_job:
    steps:
      - name: 我的第一步
        run: echo "Hello World"

jobs:
  my_job:
    steps:
      - run: echo "Hello World"

jobs:
  my_job:
    steps:
      - run: echo "Hello World"
        shell: bash

jobs:
  my_job:
    steps:
      - uses: eas/checkout
      - run: pwd # 输出：/home/expo/workingdir/build/my-app
        working_directory: ./my-app

jobs:
  my_job:
    steps:
      - uses: eas/checkout
      - uses: eas/install_node_modules
      - uses: eas/prebuild
      - name: 列出文件
        run: ls -la

jobs:
  my_job:
    steps:
      - uses: eas/checkout

jobs:
  my_job:
    steps:
      - uses: eas/checkout
        with:
          ref: feature/add-icon

jobs:
  my_job:
    steps:
      - uses: eas/download_build
        with:
          build_id: string # 必填。要下载的构建 ID。
          extensions: [apk, aab, ipa, app] # 可选。要查找的文件扩展名列表。默认为 ["apk", "aab", "ipa", "app"]。

jobs:
  build_ios:
    type: build
    params:
      platform: ios
      profile: production

  my_job:
    needs: [build_ios]
    steps:
      - uses: eas/download_build
        id: download_build
        with:
          build_id: ${{ needs.build_ios.outputs.build_id }}
      - name: 打印产物路径
        run: |
          echo "Artifact path: ${{ steps.download_build.outputs.artifact_path }}"

jobs:
  my_job:
    steps:
      - uses: eas/checkout
      - uses: eas/install_node_modules
      - uses: eas/prebuild

jobs:
  my_job:
    steps:
      - uses: eas/checkout
      - uses: eas/install_node_modules
      - uses: eas/resolve_apple_team_id_from_credentials
        id: resolve_apple_team_id_from_credentials
      - uses: eas/prebuild
        with:
          clean: false
          apple_team_id: ${{ steps.resolve_apple_team_id_from_credentials.outputs.apple_team_id }}

jobs:
  my_job:
    steps:
      - uses: eas/checkout
      - uses: eas/install_node_modules
      - uses: eas/prebuild
      - uses: eas/restore_cache
        with:
          key: cache-${{ hashFiles('package-lock.json') }}
          restore_keys: cache
          path: /path/to/cache

jobs:
  my_job:
    steps:
      - uses: eas/checkout
      - uses: eas/install_node_modules
      - uses: eas/prebuild
      - uses: eas/restore_cache
        with:
          key: cache-${{ hashFiles('package-lock.json') }}
          path: /path/to/cache

jobs:
  my_job:
    steps:
      - uses: eas/checkout
      - uses: eas/install_node_modules
      - uses: eas/prebuild
      - uses: eas/restore_cache
        with:
          key: cache-${{ hashFiles('package-lock.json') }}
          path: /path/to/cache
      - name: 构建 Android 应用
        run: cd android && ./gradlew assembleRelease
      - uses: eas/save_cache
        with:
          key: cache-${{ hashFiles('package-lock.json') }}
          path: /path/to/cache

jobs:
  my_job:
    steps:
      - uses: eas/send_slack_message
      with:
          message: 'This is a message sent to a Slack channel'
          slack_hook_url: ${{ env.ANOTHER_SLACK_HOOK_URL }}

jobs:
  my_job:
    steps:
      - uses: eas/checkout
      - name: Run tests
        run: ./scripts/run-tests.sh # 将结果写入 ./results
      - uses: eas/upload_artifact
        if: ${{ always() }}
        with:
          type: other
          name: test-results
          path: |
            results/**/*

jobs:
  my_job:
    steps:
      - uses: eas/download_artifact
        with:
          name: string # 如果未提供 artifact_id，则为必填。要下载的工件名称。
          artifact_id: string # 如果未提供 artifact_name，则为必填。要下载的工件 ID。

jobs:
  maestro_tests:
    type: maestro
    params:
      build_id: '123-abc'
      flow_path: 'path/to/flow.yaml'
  my_job:
    needs: [maestro_tests]
    steps:
      - uses: eas/download_artifact
        id: download_artifact
        with:
          name: 'iOS Maestro Test Report (junit)'
      - name: 打印 Maestro 输出
        run: echo ${{ steps.download_artifact.outputs.artifact_path }}

jobs:
  my_job:
    steps:
      - uses: eas/posthog_capture_event
        with:
          event: ota_update_published
          properties:
            branch: main

jobs:
  my_job:
    steps:
      - uses: eas/posthog_flag_rollout
        with:
          flag: new-checkout
          rollout_percentage: 25

jobs:
  my_job:
    steps:
      - uses: eas/posthog_wait_for_metric
        with:
          query: SELECT count() FROM events WHERE event = '$exception' AND timestamp > now() - INTERVAL 15 MINUTE
          operator: lt
          threshold: 10

jobs:
  my_job:
    steps:
      - uses: eas/posthog_wait_for_query
        with:
          query: SELECT count() > 0 FROM events WHERE event = 'smoke_test_passed' AND timestamp > now() - INTERVAL 30 MINUTE

jobs:
  my_job:
    steps:
      - uses: eas/posthog_annotation
        with:
          content: Published update to production

jobs:
  publish_update:
    steps:
      - uses: eas/checkout
      - uses: eas/install_node_modules
      - run: npx expo export --source-maps
      - uses: eas/posthog_upload_sourcemaps
        with:
          directory: dist

name: Greet

description: Prints a greeting for the given name.

inputs:
  - who

inputs:
  - name: who
    type: string
    default_value: world
  - name: platform
    type: string
    allowed_values: [android, ios]
    required: true

outputs:
  message:
    value: '${{ steps.make.outputs.message }}'
    description: The rendered greeting.

runs:
  steps:
    - id: make
      run: set-output message "Hello, ${{ inputs.who }}!"

set-output <name> <value>

jobs:
  my_job:
    steps:
      - id: step_1
        run: set-output variable_1 "变量 1"
      - id: step_2
        run: echo ${{ steps.step_1.outputs.variable_1 }} # 输出：变量 1

jobs:
  job_1:
    outputs:
      variable_1: ${{ steps.step_1.outputs.variable_1 }}
    steps:
      - id: step_1
        run: set-output variable_1 "变量 1"
  job_2:
    needs: [job_1]
    steps:
      - run: echo ${{ needs.job_1.outputs.variable_1 }} # 输出：变量 1

set-env <name> <value>

jobs:
  my_job:
    steps:
      - name: 设置环境变量
        run: |
          # 仅使用 export 只会让它在当前步骤中可用
          export LOCAL_VAR="仅在此步骤中"

          # 使用 set-env 会让它在后续步骤中可用
          set-env SHARED_VAR "在后续步骤中可用"

          # SHARED_VAR 目前在当前步骤的环境中还不可用
          echo "LOCAL_VAR: $LOCAL_VAR"     # 输出：仅在此步骤中
          echo "SHARED_VAR: $SHARED_VAR"   # 输出：（空）
      - name: 使用共享变量
        run: |
          # SHARED_VAR 现在可用了
          # @info #
          echo "SHARED_VAR: $SHARED_VAR"   # 输出：在后续步骤中可用
          # @end #

jobs:
  job_1:
    outputs:
      my_value: ${{ steps.step_1.outputs.my_value }}
    steps:
      - id: step_1
        run: set-output my_value "来自 job_1 的值"

  job_2:
    needs: [job_1]
    env:
      MY_VALUE: ${{ needs.job_1.outputs.my_value }}
    steps:
      - run: echo "MY_VALUE: $MY_VALUE"  # 输出：来自 job_1 的值