xfy technologyでのバージョンの定義や比較方法、バージョンの付け方のポリシーの例を紹介します。
xfyユーザーエージェントは、複数のxfyプラグインから構成されています。これらのxfyプラグインの間には、依存関係があるものがあります。依存関係にあるxfyプラグインが更新されたときには、ほかのxfyプラグインに対する互換性を確認する必要があります。また、更新されたxfyプラグインが、クライアントの環境にインストールされているxfyプラグインより新しいか新しくないかを判断する必要があります。これらを判断するときには、xfyプラグインに設定されているバージョン情報を利用します。
この文書では、xfyプラットフォームで使用できるxfyプラグインJARファイルやパッケージに設定するバージョンの仕様と、バージョン設定のガイドラインを説明します。
バージョン番号や、バージョンの比較方法に関する仕様を説明します。
xfy technologyで使用するバージョン番号は、ピリオド（.）で区切られた４つの数値で表示される文字列です。４つの数値は、前から順にメジャーバージョン、マイナーバージョン、ビルドナンバー、リビジョンを表します。
それぞれのバージョン番号を省略した場合の動作については、「バージョンの比較方法」もご覧ください。
xfy technologyでは、次のような目的でバージョン情報を利用します。
バージョンは以下のルールに基づいて比較されます。
xfy technologyでは、３種類のバージョン番号が存在します。これらは、それぞれのバージョンの仕様と規約に従い、バージョン管理されます。
xfyプラグインは、xfyプラットフォームに機能を追加するときの物理的な最小単位です。xfyプラグインのバージョンはプラグインマニフェストファイルに記述されるバージョンです。このバージョンは、xfyプラグイン開発者が規約に基づいて自由に設定できます。
このバージョンはxfyプラグイン単位で設定され、パッケージ管理ツールの内部処理のためだけに使用されます。xfyプラグインのバージョンがユーザーの目に触れることはありません。
プラグインマニフェストファイルについて詳しくは、「プラグインファイルマニフェストリファレンス」をご覧ください。
プラグインマニフェストファイルには、xfyプラグインのバージョンのほかに、対象とするxfyプラットフォームのバージョンも記載します。この項目もバージョンの仕様と規約に基づいて記述します。ただし、リビジョンとビルドナンバーは無視されます。
記述される対象のxfyプラットフォームのバージョンについては、「xfyプラグイン情報仕様」をご覧ください。
xfy technologyのパッケージは、１つ以上のプラグインから構成される論理的なまとまりです。ユーザーがxfyプラットフォームに機能を追加するときは、パッケージが最小単位となります。このパッケージにもバージョンを設定します。パッケージのバージョンは、ユーザーに直接参照されます。パッケージのバージョンは、次の目的で利用されます。
xfyコンポーネントやxfyプラグイン、パッケージを更新するときは、その変更の内容や量に基づいてバージョン番号を変更する必要があります。ここでは、一般的な更新の呼称と併せて、バージョンの設定方針の例を示します。
一般に、プログラムの更新には次のような形態があります。
このような更新の形態に合わせてバージョン番号の設定方針を決めておくと、クライアント環境にインストールされているプログラムの更新状況を調べることができます。次の表に、xfy technologyのバージョン番号を設定する方針の例を示します。
| 最初のリリース |
最初の正式バージョンであることを示すバージョン番号を設定する。 ［例］ 1.0.1.0
|
| メジャーバージョンアップ |
メジャーバージョンを1増やし、ほかの番号を初期状態に戻す。［例］ 2.0.1.0
|
| マイナーバージョンアップ |
マイナーバージョンを任意の値で増やし、ビルドナンバーとリビジョンを初期状態に戻す。メジャーバージョンは変更しない。 ［例］ 1.3.1.0
|
| リリースアップ |
ビルドナンバーやリビジョンに適切な値を設定する。メジャーバージョンとマイナーバージョンは変更しない。 ［例］ 1.0.24.3
|