バージョンとチャネル
パッケージを公開すると、バージョンが作成されます。バージョンは、その時点でのパッケージの名前、概要、コンテンツのスナップショットで、日付、動作するプラットフォーム、任意の変更履歴を伴います。公開されたバージョンが変わることはありません。パッケージを編集すると、次のバージョンの準備になります。
2 つのチャネル
Section titled “2 つのチャネル”| チャネル | 番号 | 例 | 用途 |
|---|---|---|---|
| 安定版 | MAJOR.MINOR.PATCH |
1.2.0 |
すべてのプラットフォーム:提案されるアップデートです。 |
| 開発版 | MAJOR.MINOR.PATCH-dev.N |
1.3.0-dev.2 |
テスト:次の安定版のプレリリースです。 |
開発バージョンは常に区別して表示されます。パッケージのページで、オレンジ色のバッジ、専用の開発中カード、開発版をダウンロードボタンが付きます。
番号の決め方
Section titled “番号の決め方”バージョン番号を直接入力することはありません。段階を選ぶと、ダイアログにその番号が表示されます(バージョン 1.1.0 を公開します。)。
安定版:段階は、最も高い安定版に対して適用されます。
| 段階 | 使う場面 | 1.2.3 から |
|---|---|---|
| パッチ | 修正:説明の誤字、スクリプトの行の修正 | 1.2.4 |
| マイナー | 追加:新しいモデル、新しいプロファイル | 1.3.0 |
| メジャー | 互換性のない変更:項目の削除や再編成 | 2.0.0 |
最初の安定版は、メジャーの 1.0.0、またはパッケージがまだ本番環境向けでない場合は初期開発の 0.1.0 です。
開発版:段階は目標とする安定版を示し、番号はその目標に -dev.N を付けたものになります。N は、その目標ごとに増えていきます。
| 操作 | バージョン |
|---|---|
| 初回公開、安定版、メジャー | 1.0.0 |
| 新しいモデルを追加、開発版、マイナー | 1.1.0-dev.1 |
| スクリプトを修正、開発版、マイナー | 1.1.0-dev.2 |
| 全員向けの準備完了、安定版、マイナー | 1.1.0 |
| 誤字を修正、安定版、パッチ | 1.1.1 |
| プロファイルを再編成、開発版、メジャー | 2.0.0-dev.1 |
バージョンはセマンティックバージョニングと同じ順序で並びます。開発バージョンは、それが目指す安定版より前に位置します:1.0.0 < 1.1.0-dev.1 < 1.1.0-dev.2 < 1.1.0。
最新バージョンと開発バージョン
Section titled “最新バージョンと開発バージョン”- パッケージの最新バージョン(最新バッジ)は、最も高い安定版です。
- 開発版のバージョンは、最も高い開発バージョンが最新バージョンより上にある場合の、その開発バージョンです。
1.1.0を公開すると、1.1.0-dev.2は開発バージョンとして表示されなくなります。
エディターのヘッダーには両方が表示され、コンテンツがそれらと異なる場合は未公開の変更も表示されます。
チャネルを公開できる条件
Section titled “チャネルを公開できる条件”- 安定版は、最も高い安定版以降に名前、概要、コンテンツが変更されている場合に公開できます(開発バージョンがすでに同じコンテンツを持っている場合も含みます)。
- 開発版は、いずれかのチャネルの最後のバージョン以降に何かが変更されている場合に公開できます。
公開するものがないチャネルは選べません(このチャネルの前回のバージョンから変更はありません。)。どちらも公開できない場合、バージョンページに 前回のバージョンから変更はありません。 と表示されます。
プラットフォームでのバージョンの扱い
Section titled “プラットフォームでのバージョンの扱い”- プラットフォームはパッケージをインストールし、安定版で最新の状態に保ちます。
- 開発バージョンはテスト用のプラットフォーム向けです。開発版のファイルをダウンロードするか、接続されたプラットフォームで選択して、意図的にインストールします。プラットフォームガイドの バージョンと開発チャネル を参照してください。
- コンテンツの各項目は、バージョンが変わっても同じ ID を保ちます。そのため、アップデートではプラットフォームにすでにある項目が重複せずに更新され、削除した項目は削除されます。
- インストール済みのバージョンより低いバージョンをインストールすることはダウングレードです。プラットフォームは、戻す前に確認を求めます。