版本發布

自 Homebrew 1.0.0 以來，大多數 Homebrew 用戶（那些未執行 dev-cmd 或設定 HOMEBREW_DEVELOPER=1 的用戶，根據分析資料約佔 99.9%）需要在 Homebrew/brew 儲存庫 上標記標籤，才能收到 Homebrew 的新版本。製作新的 Homebrew 版本有幾個步驟：

  1. 檢查在 Homebrew/brew 中是否有任何緊急需要在下次發布之前修復或合併的

    如果有，請修復並合併這些變更。

  2. 確保
    • 在至少幾個小時（理想情況下為 4 小時）內沒有發生任何程式碼變更，
    • 至少有一個 Homebrew/homebrew-core 請求拉取 CI 工作已成功完成，
    • Homebrew/brew master CI 工作的狀態很明確（即主要工作為綠色或在重新執行後為綠色）
    • 您確信在目前的 master 分支上沒有重大回歸。

  3. 執行 brew release 以建立新的草稿版本。對於主要或次要版本升級，請分別傳遞 --major 或 --minor。

  4. 在 GitHub 上發布草稿版本。

如果是主要或次要版本（例如 X.0.0 或 X.Y.0），則還有幾個步驟

  1. 在建立標籤之前，您應該
    • 刪除任何 odisabled 程式碼，
    • 將任何 odeprecated 程式碼設為 odisabled，
    • 取消註解任何 # odeprecated 程式碼
    • 新增任何所需的 odeprecations。

    同時刪除任何傳遞 replacement: ... 的命令參數定義。

  2. 為 https://brew.sh 編寫一篇版本說明部落格文章（例如 brew.sh#319）。這應該使用 brew release [--major|--minor] 的輸出作為輸入，但調整措辭以更易於閱讀，並說明不僅變更了什麼，還說明了為什麼變更。

  3. 當版本發布且部落格文章已合併時，請將部落格文章推文為 @MacHomebrew Twitter 帳戶，或自行推文並使用 @MacHomebrew Twitter 帳戶轉推（憑證在 1Password 中）。

  4. 考慮是否要提交到其他來源，例如 Hacker News、Reddit。
    • 優點：獲得更廣泛的觸及率和使用者回饋
    • 缺點：負面評論很常見，而且人們會趁機抱怨 Homebrew（不論他們是否使用過）

請勿手動根據 master 分支上的舊提交建立版本。很難判斷使用者是否已充分測試這些提交，或者它們是否會對 Homebrew/homebrew-core 的目前狀態造成負面影響。如果急需一個新分支，但 master 上有一些項目還不能發布（例如新的不建議使用項目，而您想建立一個修補版本），請回復相關的 PR，遵循上述程序，然後回復已回復的 PR 以重新套用於 master 上。

Fork me on GitHub