Zed 版本发布

在此处阅读有关 Zed 发布渠道的信息。

周三发布流程

您需要对 Zed 仓库拥有写入权限才能执行此操作。

此过程中使用的各种服务的凭据可在 1Password 中找到。

使用 releases Slack 频道通知团队发布即将开始。这对于周三的小版本更新发布主要是一种形式，但在进行补丁发布时可能会有益，因为其他开发人员可能已经提交了他们希望挑选的修复程序。

开始构建

检出 main 并确保您的工作副本是干净的。
运行 git fetch && git pull 以确保您在本地拥有最新的提交。
运行 git fetch --tags --force 以强制确保您的本地标签与远程同步。
运行 ./script/get-stable-channel-release-notes 并将输出存储在本地。
运行 ./script/bump-zed-minor-versions。
- 按照指示推送标签和分支。
运行 ./script/get-preview-channel-changes 并将输出存储在本地。

注意：始终优先处理稳定版发布。如果您已完成稳定版发布说明的汇总，您可以继续处理预览版发布说明的汇总，但一旦稳定版构建完成，请完成稳定版的其余步骤以完全发布。预览版可以在之后完成。

稳定版

汇总稳定版发布说明。
- 按照脚本末尾的说明，将发布说明汇总到一个结构中。
一旦稳定版发布草稿上传到 GitHub Releases，将稳定版发布说明粘贴到其中并保存。
- 不要发布草稿！
检查稳定版发布资产。
- 确保稳定版发布作业已无错误地完成。
- 确保草稿具有正确数量的资产——当前每个发布有 12 个资产（截至 v0.211）。
- 下载稳定版发布草稿的工件并测试您可以在本地运行它们。
在 GitHub Releases 上发布稳定版草稿。
- 使用 Vercel 检查网站重建的进度。一旦重建完成，发布将公开。
将稳定版发布说明发布到社交媒体。
- Bluesky 和 X 帖子将已在 Buffer 中构建为草稿。
- 仔细检查链接。
- 发布两者，一次一个，确保两者都发布到各自的平台。
发送稳定版发布说明电子邮件。
- 电子邮件广播将已在 Kit 中构建为草稿。
- 仔细检查链接。
- 发布电子邮件。

预览版发布

汇总预览版发布说明。
- 获取脚本的输出，并通过将每个发布说明行组织到类别中来构建发布说明。
- 使用以前的版本作为初始大纲。
- 确保将 Credit 行（如果存在）附加到每个发布说明行的末尾。
一旦预览版发布草稿上传到 GitHub Releases，将预览版发布说明粘贴到其中并保存。
- 不要发布草稿！
检查预览版发布资产。
- 确保预览版发布作业已无错误地完成。
- 确保草稿具有正确数量的资产——当前每个发布有 12 个资产（截至 v0.211）。
- 下载预览版发布草稿的工件并测试您可以在本地运行它们。
在 GitHub Releases 上发布预览版草稿。
- 使用 Vercel 检查网站重建的进度。一旦重建完成，发布将公开。

为下周的稳定版发布准备内容

根据预览版中的热门项目构建社交媒体帖子。
- 在 tweets 频道中起草文案。
- 创建预览媒体（视频、屏幕截图）。
  - 对于您拍摄视频的功能，请尝试创建仅包含照片的替代版本以用于电子邮件，因为视频和 GIF 不太适合电子邮件。
  - 将所有创建的媒体存储在我们的 Google Drive 中的 Feature Media 中。
- 在 Buffer 中构建 X 和 Bluesky 帖子草稿（文案和媒体），以供下周的稳定版发布。
注意：这些是预览项目，您可能会发现错误。 这是向团队报告这些发现的绝佳时机！
根据预览版中的热门项目构建电子邮件。
- 您可以重复使用预览版社交媒体帖子中的文案和照片媒体。
- 在 Kit 中创建一封电子邮件草稿，以供下周的稳定版发布。

补丁发布流程

如果您的 PR 修复了恐慌或崩溃，您应该将其挑选到当前的稳定版和预览版分支。如果您的 PR 修复了最近发布代码中的回归问题，您应该将其挑选到预览版。

您需要对 Zed 仓库拥有写入权限才能执行此操作

正常地向 main 发送包含您的更改的 PR。
合并后，将提交本地挑选到任一发布分支 (v0.XXX.x)。
- 在某些情况下，您可能需要处理合并冲突。通常，这会在挑选到稳定版时发生，因为稳定版分支比预览版分支更“旧”。
提交挑选后，运行 ./script/trigger-release {preview|stable}。这将提升版本号，创建新的发布标签，并启动发布构建。
- 这也可以从 GitHub Actions UI 运行：
一旦发布草稿上传到 GitHub Releases，校对并根据需要编辑发布说明并保存。
- 暂不要发布草稿。
检查发布资产。
- 确保稳定版/预览版发布作业已无错误地完成。
- 确保每个草稿具有正确数量的资产——当前每个发布有 10 个资产。
- 下载每个发布草稿的工件并测试您可以在本地运行它们。
一次一个地发布稳定版/预览版草稿。
- 使用 Vercel 检查网站重建的进度。一旦重建完成，发布将公开。

夜间发布流程

除了公开发布，我们还有一个夜间构建，我们鼓励员工使用。夜间版每天通过 cron 发布一次，您可以根据需要频繁地发布。没有发布说明或公告，因此您只需将更改合并到 main 并运行 ./script/trigger-release nightly。