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がサポートする最新バージョンに更新します。
バージョン引数
このコマンドは、次のバージョンを指定するためのオプションの引数を1つ受け入れます。この引数を省略した場合、デフォルトで 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 version bumped to 1.0.1新しいマイナーバージョンへの引き上げ
新機能をリリースするには、マイナーバージョンを引き上げることができます。
Minor Version Bump
blocklet version minor
# Output:
# ✔ Blocklet version bumped to 1.1.0特定のバージョンを設定してコミットする
明示的なバージョン番号を設定し、CLIにその変更をコミットさせることもできます。
Set Version and Commit
blocklet version 2.0.0 --gitCommit
# Output:
# ✔ Blocklet version bumped to 2.0.0
# (Also runs 'git add blocklet.yml' and 'git commit ...')ワークフローにおけるバージョニング
version コマンドは、コードの変更を完了し、配布可能なバンドルを作成する前の、パッケージングおよび配布ワークフローに適合します。
blockletのバージョンを正常に更新した後、配布プロセスの次のステップに進む準備が整いました。