ほとんどの Node パッケージと同様に、Sails はセマンティック バージョニングに準拠しています。たとえば、Sails v0.11.3 を使用していて、Sails v0.11.4 にアップグレードする場合、アプリケーションコードを変更する必要はありません。これは、パッチリリースと呼ばれます。一方、Sails v0.11.3 から v1.0.0 にアップグレードする場合、いくつかの破壊的な変更が予想されます。つまり、新しいバージョンを使用するには、Sails アプリのコードを変更する必要があります。フレームワークやツールでは、時間の経過とともに一部の破壊的な変更は避けられませんが、Node と Sails の API が安定し続けるにつれて、このような変更は少なくなると予想されます。それまでの間、コアメンテナーは破壊的な変更を最小限に抑え、可能な限り後方互換性を維持するよう努めています。
バージョン間の変更の詳細、およびアプリに必要な変更を行うための移行ガイドについては、該当するページを参照してください。
- Node.js と同様に、v1.0 より前の Sails バージョンのマイナーバージョンアップには、破壊的な変更が含まれていました。たとえば、v0.11.3 から v0.12.0 にアップグレードすると、コードにいくつかの変更を加える必要がある場合があります。ただし、v1.0.0 以降では、マイナーバージョン(2 番目の数字)のリリースは完全に後方互換性があります。たとえば、v1.1.0 から v1.2.0 にアップグレードしてもコードを変更する必要はありませんが、v2.0.0 にアップグレードする場合は変更が必要になる場合があります。
- 最新リリースより 1 つ以上のバージョンが遅れていて、問題が発生した場合は、アプリを 1 ステップずつ更新することを検討してください。移行ガイドは特定のバージョンの違いを念頭に置いて書かれており、できるだけ多くの変数を分離するのが最善です。たとえば、Sails v0.11 を実行していて、Sails v1.5.18 にアップグレードしようとしていますが問題が発生している場合は、最初に Sails v0.11、次に v0.12、そして v1.5.18 にアップグレードしてみてください。