blocklet version 命令是一个方便的实用工具，用于更新 blocklet.yml 文件中的 blocklet 版本号。它遵循语义化版本（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 开始） |
|---|---|---|
(无) / 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
# Output:
# ✔ Blocklet 版本已提升至 1.0.1提升到新的次版本号
要发布新功能，你可以提升次版本号。
Minor Version Bump
blocklet version minor
# Output:
# ✔ Blocklet 版本已提升至 1.1.0设置特定版本并提交
你也可以设置一个明确的版本号，并让 CLI 为你提交更改。
Set Version and Commit
blocklet version 2.0.0 --gitCommit
# Output:
# ✔ Blocklet 版本已提升至 2.0.0
# (同时运行 'git add blocklet.yml' 和 'git commit ...')工作流中的版本管理
version 命令适用于打包和分发工作流，在你完成代码更改之后、创建可分发包之前使用。
成功更新你的 blocklet 版本后，你就可以进行分发流程的后续步骤了。