バージョン制約と Lockfile

version constraintは、プロジェクトが受け入れるパッケージのリリースをpubに伝えます。修正を取り込みながら、互換性を壊す変更を避けるための仕組みです。🎯

Dartパッケージはsemantic versioning（major.minor.patch）に従います。majorの更新は互換性を壊す変更、minorの更新は機能追加、patchの更新はバグ修正を示します。

caretの^1.2.0は、1.2.0以上2.0.0未満のバージョンを受け入れます。pubが使う、扱いやすいデフォルトです。

数値だけを書くと、他ではなくそのバージョンをexactly指定することになります。特定のリリースが必要な場合に限り、慎重に使ってください。

比較演算子を使ってrangeを明示できます。下限と上限の両方を細かく制御できます。

anyを使うと、すべてのバージョンを受け入れます。将来のメジャーリリースで壊れるおそれがあるため危険です。代わりにcaretを優先してください。

pubが依存関係を解決すると、選択した正確なバージョンをpubspec.lockに記録します。このファイルによって、実際に全員がインストールするバージョンを固定できます。

Lockfileはreproducibleなビルドを保証します。チームメンバーがpub getを実行しても、予期しないアップグレードではなく、テスト済みのものとまったく同じバージョンが取得されます。

アプリではpubspec.lockをバージョン管理にcommitします。再利用可能なパッケージでは、利用者が自分でバージョンを解決できるよう、含めないでください。

dart pub upgradeを実行すると、pubspec.lockを制約で許可される最新バージョンに更新できます。通常のgetでは既存の固定バージョンが維持されます。

2つのパッケージが互換性のないバージョンを要求すると、pubはconflictを報告します。その場合は制約を緩和するか、互換性のあるパッケージバージョンを選びます。

制約^1.2.0では何が許可されますか。

これで、caretや範囲などのconstraintsを読み取り、pubspec.lockによって正確なバージョンを固定し、再現可能で競合のないビルドを実現できることを学びました。🎉