バージョンと互換性

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.

ルール

springBootVersion (spring_boot_dart の定数) は実行中のバージョンです。${spring-boot.version} でバナーに表示できます。

Spring (Java) との対応

Spring Boot の BOM と Spring Cloud の互換性検証ツールがこの役割を果たします。ここでは pub のソルバーと、ビルド時の requires のチェックがそれらの代わりになります。

関連項目