The services layer now depends on the scheduler layer. Previously, the opposite was true. This may affect you if you have defined custom bindings overriding Flutter's `SchedulerBinding` or `ServicesBinding`.
Original behavior
Prior to this change, the scheduler layer was dependent on the services layer. This change reverses the dependency chain and allows the services layer to make use of the scheduling primitives in the scheduler layer. For example, services in the services layer can now schedule tasks by using `SchedulerBinding.scheduleTask`.
New behavior
The change only affects users who are defining their own custom bindings based on Flutter's `SchedulerBinding` and `ServicesBinding`.
- Who is affected
- affects users who are defining their own
- Practical impact
- Behaviour or API differences that can break builds or change runtime behaviour.
- What action should I take?
- Follow the official migration guide below, update affected call sites, run `dart fix --apply` where a fix is available, then run your tests.
Before and after (from the official guide)
| 1 | − | class FooBinding extends BindingBase with ServicesBinding, SchedulerBinding { |
| 2 | // ... | |
| 3 | } |
| 1 | + | class FooBinding extends BindingBase with SchedulerBinding, ServicesBinding { |
| 2 | // ... | |
| 3 | } |
Raw before / after
class FooBinding extends BindingBase with ServicesBinding, SchedulerBinding {
// ...
}class FooBinding extends BindingBase with SchedulerBinding, ServicesBinding {
// ...
}Official migration guide (excerpt, © The Flutter Authors, CC BY 3.0)
Prior to this change, the ServiceBinding had to be defined before the
SchedulerBinding. With this change, it is the other way around:
Code before migration:
class FooBinding extends BindingBase with ServicesBinding, SchedulerBinding {
// ...
}Code after migration:
class FooBinding extends BindingBase with SchedulerBinding, ServicesBinding {
// ...
}AI_PROVIDER (for example to openai-compatible with a local Ollama or LM Studio endpoint) to enable grounded explanations. Everything else on this page works without an AI provider.Listed in the official breaking-changes index (docs.flutter.dev/release/breaking-changes).
An official announcement or migration guide documents an intended behaviour or API change. A verified source change (git diff) shows code changed but does not by itself prove a public API is breaking. AI interpretations are labelled and never used to classify a change.
- Official migration guide
- ServicesBinding
- SchedulerBinding
- Reverse dependency between services and scheduler
- Revert bindings dependency workaround
- Source commit
- b3045439b7c0
- Source last updated
- Oct 21, 2026
- Last synchronized
- Oct 21, 2026
- Publication status
- published
Publication history
- Oct 21, 2026, 8:31 PM: new → published (ingestion) — Backed by an official breaking-change/migration guide.
AI_PROVIDER (for example to openai-compatible with a local Ollama or LM Studio endpoint) to enable grounded explanations. Everything else on this page works without an AI provider.