バージョン番号
ウィジェットのリリースには、2.1.0のようなバージョン番号が付きます。番号を自分で選ぶ必要はありません。ウィジェットの利用者にとって何が変わったかをもとにBlotchが決め、公開ダイアログにどの種類のリリースかが表示されます。最初のリリースは必ず1.0.0です。
| リリース | 例 | どんなとき |
|---|---|---|
| パッチ | 2.1.0 → 2.1.1 | コードの変更など、利用者にとって何も変わらないとき。 |
| マイナー | 2.1.0 → 2.2.0 | 利用者が気にしなくてよい新しい要素が加わったとき。 |
| メジャー | 2.1.0 → 3.0.0 | 利用者の設定を壊すおそれのある変更があるとき。いつアップグレードするかは利用者が選びます。 |
変更ごとのリリースの種類
| 変更 | リリース |
|---|---|
| コードのみの変更、入力項目の並べ替え | パッチ |
| 入力項目の説明の変更 | パッチ |
| 連携の削除 | パッチ |
| 任意の入力項目の追加 | マイナー |
| 選択タイプへの選択肢の追加 | マイナー |
| 必須の入力項目を任意に変更 | マイナー |
| 必須の入力項目の追加 | メジャー |
| 入力項目の削除、名前の変更 | メジャー |
| 入力項目のタイプの変更 | メジャー |
| 選択肢の削除 | メジャー |
| 任意の入力項目を必須に変更 | メジャー |
| 連携の追加 | メジャー |
1つのリリースに複数の変更が含まれる場合は、いちばん大きい変更で決まります。
メジャーリリースの後も、以前からウィジェットを追加している人は、アップグレードするまで設定したときのバージョンを使い続けます。公開とバージョンのリリースを参照してください。