本指南旨在協助維護人員有效維護 cask 儲存庫。它應與更通用的 維護人員指南 搭配使用。
本指南適用於兩個 cask 儲存庫
以下是 cask PR 中最常見的情況清單,以及如何處理它們
version
和 sha256
都變更(維持相同格式):合併。sha256
變更:合併,除非版本也需要更新。上游供應商在原處更新版本並不少見。不過,請注意上游可能遭到駭客入侵等情況。livecheck
已更新:盡量發揮判斷力,並確保變更符合 livecheck
指南。version
變更或 version
格式變更:盡量發揮判斷力,如果看起來正確,就合併(這相對罕見)。如有疑問,請在 GitHub 或 Slack 上詢問其他 cask 維護人員。
請注意,與配方不同,cask 不會將 sha256
節視為有意義的安全措施,因為維護人員無法實際檢查它們的真實性。Cask 從上游下載;如果惡意行為者入侵 URL,他們可能會入侵某個版本,並使其看起來像是更新。
一般來說,使用 GitHub 的「合併」按鈕是合併 PR 的最佳方式。當 PR 僅修改一個 cask 時,可以使用此按鈕,無論提交次數或提交訊息格式是否正確。使用此方法合併時,可以視需要修改提交訊息。通常,版本升級提交訊息會採用 將 CASK 從 OLD_VERSION 更新至 NEW_VERSION
的格式。
如果 PR 修改多個 cask,請使用「重新設定基礎並合併」按鈕來合併 PR。這將使用 PR 中的提交訊息,因此合併前請確保它們適當。如有需要,請簽出 PR,壓縮/重新表述提交,並強制推回 PR 分支,以確保正確的提交格式。
最後,請務必感謝貢獻者提交 PR!
維護者可以透過新增 /rebase
註解,輕鬆將 PR 重新基礎化到最新的 master
分支。一旦重新基礎化進行中且完成,BrewTestBot
將自動重新基礎化 PR 並對註解新增反應。