セマンティックバージョニング
セマンティックバージョニング (semver とも呼ばれます) は、破壊的変更を判別しやすくすることを主な特徴とするバージョニングの方式です。バージョンは、ドットで区切られた 3 つの数字 .. で構成されます。たとえば、2.12.5、0.1.0、10.5.35 は有効な semver のバージョン番号です。- 最初の数字は メジャー変更 を表します。これは、ライブラリの API が後方互換性のない形で変更されたことを意味します。バージョンのメジャー番号が上がると、そのライブラリの公開 API が変更されたことになります。たとえば、以前から非推奨とされていたコードや機能がコードベースから削除されます。
- 2 番目の数字は マイナー変更 を表します。これは、後方互換性を維持したまま、ライブラリの API に新機能が追加されたり、一部が非推奨になったりしたことを意味します。新しいマイナーバージョンは通常、安全に利用できると想定されるため、更新をおすすめしています。ただし、お客様ごとのコンポーネントの利用方法をすべて把握することは不可能なため、変更が現在の利用状況に影響する可能性は常にあります。そのため、更新前に確認とテストを行うことを推奨します。
- 3 番目の数字は パッチ変更 を表します。これは、不具合が修正されており、ユーザー向け API には影響しないことを意味します。通常は安全に更新できますが、テストの実施は常に推奨されます。
本番環境での利用
Auth0 では、一部のライブラリを配信している Content Delivery Network (CDN) へのリンクを提供しています。コード内でコンポーネントをどのように参照するかによって、変更が自動的に反映されるかどうか、また反映されるタイミングが変わります。たとえば、script 内でメジャーリリースにリンクしている場合、新しいマイナーリリースが出ると、公開され次第その更新が反映されます。開発環境や Auth0 の検証では、この方法を推奨しています。以下はソースファイルを埋め込む例です。v が付きます。たとえば、バージョン 5.2.3 のタグは v5.2.3 になります。