• 如何更新 Homebrew Formula

如何更新 Homebrew Formula

---

本文档介绍如何为新的 SUMO 版本更新 macOS 的 Homebrew Formula。

GitHub 仓库#

所有相关文件都可以在以下仓库中找到：https://github.com/DLR-TS/homebrew-sumo。 请注意，brew 需要 homebrew- 前缀才能使 brew tap dlr-ts/sumo 命令生效。

Formula 分步更新指南#

在新的 SUMO 版本发布后（参见 HowToRelease），请按照以下步骤操作（假设您已经检出该仓库）：

1. 运行 bash 脚本：

   ./update_formula.sh <NEW_VERSION> <SUMO_SRC_URL>

   其中 <NEW_VERSION> 是新的 sumo 版本的版本字符串（例如 1.9.2），而 <SUMO_SRC_URL> 是相应源代码存档（包含示例）的 URL（例如 https://sumo.dlr.de/releases/1.9.2/sumo-src-1.9.2.tar.gz）。

   该脚本会自动执行以下操作（包括本地 git 提交）：

   • 归档旧的 formula（针对之前的 sumo 版本）
   • 创建一个新的临时 sumo git 分支（与 formula 同名）
   • 升级 formula 版本（通过 brew bump-formula-pr）
   • 删除 formula 中（现已过时的）bottle 代码块
   • 更新 Aliases/ 中的符号链接
   • 更新 README.md 中的版本号
     
     

2. 将本地提交推送到上游：

   git push --set-upstream origin sumo

3. 从新分支创建一个拉取请求（pull request），以触发 tests.yml 工作流，该工作流会执行 formula 审核、安装测试和 bottle 创建。

4. 如果之前的工作流成功运行，请使用 pr-pull 标签标记该 PR。这将触发 publish.yml 工作流，该工作流会将 bottles 上传到 GitHub，并随后删除临时的 sumo 分支。