
# バージョンと互換性

Java はライブラリの衝突を BOM で解決します。pub はアプリケーションごとに各パッケージのバージョンをちょうど一つに解決するため、衝突が実行時まで隠れることはありません。`pub get` が失敗し、原因となるパッケージを示します。残る課題は、ファミリーの一貫性を保つことと、互換性のないスターターを分かりやすくすることです。

## 使う理由

アプリケーションは複数のスターターに依存し、それぞれが `spring_boot_dart` のあるバージョンに対してビルドされています。古いバージョン向けに作られたスターターは、変更された API を使っているかもしれません。以下のチェックは、分かりにくいコンパイルエラー、さらに悪い場合は実行時の誤った動作の代わりに、明確なメッセージでビルドを止めます。

## 例

```dart
// スターターの lib/spring_auto_configuration.dart
@AutoConfigurationModule(requires: '^0.7.0')
final BeanModule neonCacheAutoConfiguration = $neonCacheBeans;
```

`spring_boot_dart` 0.6.3 を使うアプリケーションがこのスターターを追加すると、`build_runner` から次のメッセージを受け取ります。

```text
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` のチェックがそれらの代わりになります。

## 関連項目

- [自動構成とスターター](auto-configuration.md)
- [ジェネレーター: 自動構成](../spring-core-dart-generator/auto-configurations.md)
