本指南旨在帮助维护人员有效地维护 cask 存储库。它应与更通用的 维护人员指南 结合使用。
本指南适用于这两个 cask 存储库
以下是 cask PR 中出现的最常见情况及其处理方法
version
和 sha256
都更改(保持相同格式):合并。sha256
更改:合并,除非版本也需要更新。上游供应商就地更新版本的情况并不少见。但是,请注意,例如上游可能已被黑客入侵。livecheck
已更新:根据你的最佳判断,并尝试确保更改遵循 livecheck
指南。version
更改或 version
格式更改:根据你的最佳判断,如果看起来正确,则合并(这种情况相对罕见)。如有疑问,请在 GitHub 或 Slack 上询问其他 cask 维护人员。
请注意,与公式不同,cask 不认为 sha256
节是有效的安全措施,因为维护人员无法实际检查它们的真实性。Cask 从上游下载;如果恶意行为者破坏了 URL,他们可能会破坏一个版本并使其看起来像更新。
通常,使用 GitHub 的“合并”按钮是合并 PR 的最佳方式。当 PR 仅修改一个 cask 时,可以使用此方法,无论提交数或提交消息格式是否正确。使用此方法合并时,可以根据需要修改提交消息。通常,版本升级提交消息遵循以下形式 Update CASK from OLD_VERSION to NEW_VERSION
。
如果 PR 修改了多个 cask,请使用“重新提交并合并”按钮合并 PR。这将使用 PR 中的提交消息,因此在合并之前确保它们合适。如果需要,签出 PR,压缩/重新表述提交并强制推送到 PR 分支以确保正确的提交格式。
最后,务必感谢提交 PR 的贡献者!
维护人员可以通过添加 /rebase
注释,轻松地将 PR 重新基于最新的 master
分支。一旦重新基于操作正在进行且完成,BrewTestBot
将自动重新基于 PR 并对注释添加反应。