バージョンと互換性
Java はライブラリの衝突を BOM で解決します。pub はアプリケーションごとに各パッケージのバージョンをちょうど一つに解決するため、衝突が実行時まで隠れることはありません。pub get が失敗し、原因となるパッケージを示します。残る課題は、ファミリーの一貫性を保つことと、互換性のないスターターを分かりやすくすることです。
使う理由
アプリケーションは複数のスターターに依存し、それぞれが spring_boot_dart のあるバージョンに対してビルドされています。古いバージョン向けに作られたスターターは、変更された API を使っているかもしれません。以下のチェックは、分かりにくいコンパイルエラー、さらに悪い場合は実行時の誤った動作の代わりに、明確なメッセージでビルドを止めます。
例
// スターターの lib/spring_auto_configuration.dart
@AutoConfigurationModule(requires: '^0.7.0')
final BeanModule neonCacheAutoConfiguration = $neonCacheBeans;
spring_boot_dart 0.6.3 を使うアプリケーションがこのスターターを追加すると、build_runner から次のメッセージを受け取ります。
Incompatible starter: neon_cache requires spring_boot_dart ^0.7.0, but 0.6.3 is used.
Upgrade spring_boot_dart to a version in ^0.7.0, or use a version of neon_cache made for spring_boot_dart 0.6.3.
ルール
- リリーストレイン。
spring_core_dart、spring_core_dart_generator、spring_boot_dart、そしてspring_boot_starter_*パッケージは常に一つのバージョン (執筆時点で 0.7.1) を共有し、互いに^<version>で依存します。すべてに同じバージョンを使ってください。 - 1.0 より前は後方互換性がありません。 どのリリースでも API、プロパティ、動作の名前や内容が変わる可能性があります。破壊的変更は各パッケージの CHANGELOG に列挙されています。
requiresは pub のバージョン範囲です (^0.7.0、'>=0.6.0 <0.8.0')。ジェネレーターはこれをspringBootVersionと比較し、一致しなければビルドを止めます。null(デフォルト) はどのバージョンも受け入れます。- サードパーティーの制約は広く。 スターターは、ソルバーが共通のバージョンを見つけられるよう、制約を広く保ちます (
dio: '>=5.0.0 <7.0.0')。 - 非常口: アプリケーションの
pubspec.yamlのdependency_overrides。Maven で管理されたバージョンを上書きするのと同じです。
springBootVersion (spring_boot_dart の定数) は実行中のバージョンです。${spring-boot.version} でバナーに表示できます。
Spring (Java) との対応
Spring Boot の BOM と Spring Cloud の互換性検証ツールがこの役割を果たします。ここでは pub のソルバーと、ビルド時の requires のチェックがそれらの代わりになります。