This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

了解如何在删除 GitHub 分支时，使用 EAS Workflows 删除 EAS Update 分支。

你可能会将更新发布到以 GitHub 分支命名的 EAS Update 分支，例如使用 eas update --auto、带有 branch: ${{ github.ref_name }} 的 update 工作流作业，或者 在每个分支上预览更新。当你这样做时，删除 GitHub 分支会留下相应的 EAS Update 分支。此工作流会在 Git 分支被删除时清理这个孤立的 EAS Update 分支。

开始使用

以下工作流会删除与已删除的 GitHub 分支同名的 EAS Update 分支：

name: 分支清理

on:
  ref_delete:
    branches: ['*', '!main']

jobs:
  delete-update-branch:
    type: branch-delete
    params:
      branch_name: ${{ github.ref_name }}

其工作原理

1. on.ref_delete 会在匹配模式的 GitHub 分支被删除时运行。上面的示例会在除 main 之外的所有分支上触发。
2. branch-delete 作业会删除名为 ${{ github.ref_name }} 的 EAS Update 分支，该名称与被删除的 Git 分支相同。
3. 使用默认的 fail_on_missing: false 时，即使 EAS Update 分支已经被删除或从未存在过，作业也会成功。

重要说明

• github.sha 是默认分支，而不是已删除引用的最后一次提交。有关 ref_delete 运行中的插值细节，请参阅 github 上下文参考。
• 渠道映射会阻止删除：如果某个渠道指向 EAS Update 分支，删除将失败，并报出与渠道映射相关的错误。
• 对于你永远不想清理的分支，可在 on.ref_delete.branches 中使用取反模式（例如 !main 或 !release/**）来保护它们。