blocklet version 指令是一個方便的工具，用於更新您 blocklet 在 blocklet.yml 檔案中的版本號。它遵循語意化版本 (semver) 的規則，以確保版本號的增長一致且可預測。在您打包和分發 blocklet 的新版本之前，這是一個關鍵的步驟。
用法
此指令應在您的 blocklet 專案的根目錄下執行。
Basic Usage
blocklet version [<newversion> | patch | minor | major | prepatch | preminor | premajor | prerelease] [options]運作方式
此指令會執行以下操作：
- 讀取當前目錄中的
blocklet.yml檔案。 - 解析
version欄位以確定當前版本。 - 根據提供的參數計算下一個版本（預設為
patch）。 - 將
blocklet.yml中的version欄位更新為新版本。 - 將
specVersion更新為 CLI 支援的最新版本。
版本參數
此指令接受一個可選參數來指定下一個版本。如果省略此參數，預設為 patch。
| 參數 | 描述 | 範例 (從 1.2.3 開始) |
|---|---|---|
(none) / patch | 增加修補程式版本號（例如，用於錯誤修復）。 | 1.2.4 |
minor | 增加次版本號（例如，用於新功能）。 | 1.3.0 |
major | 增加主版本號（例如，用於破壞性變更）。 | 2.0.0 |
prepatch | 增加修補程式版本號作為預發行版本。 | 1.2.4-0 |
prerelease | 增加預發行版本的標識符。 | 從 1.2.4-alpha.0 到 1.2.4-alpha.1 |
<version> | 設定一個具體、有效的版本號。 | 3.0.0 |
選項
您可以使用以下選項來修改指令的行為：
| 選項 | 描述 |
|---|---|
--gitCommit | 自動將 blocklet.yml 加入 Git 暫存區，並建立一個訊息為 blocklet version <new_version> 的提交。 |
--force | 即使會導致 specVersion 降級，也強制更新版本。除非您確定此變更，否則通常不建議這樣做。 |
範例
增加修補程式版本號
如果您目前的版本是 1.0.0，執行不帶參數的指令會將其升級到 1.0.1。
Basic Patch Update
blocklet version
# 輸出:
# ✔ Blocklet 版本已升級至 1.0.1升級到新的次版本號
要發布新功能，您可以升級次版本號。
Minor Version Bump
blocklet version minor
# 輸出:
# ✔ Blocklet 版本已升級至 1.1.0設定特定版本並提交
您也可以設定一個明確的版本號，並讓 CLI 為您提交變更。
Set Version and Commit
blocklet version 2.0.0 --gitCommit
# 輸出:
# ✔ Blocklet 版本已升級至 2.0.0
# (同時執行 'git add blocklet.yml' 和 'git commit ...')工作流程中的版本管理
version 指令適用於您完成程式碼變更之後、建立可分發套件之前的打包和分發工作流程。
成功更新您的 blocklet 版本後，您就可以進行分發流程的後續步驟了。