Migration guide for RouteSettings copyWith
Summary
#
The RouteSettings.copyWith method is removed, and apps that use
it need to use the constructor to create a new RouteSettings
instance instead.
Context
#
With the introduction of the Page
class,
the RouteSettings.copyWith was no longer a viable API.
Description of change
#RouteSettings.copyWith was removed
Migration guide
#Code before migration:
RouteSettings newSettings = oldSettings.copyWith(name: 'new name');
Code after migration:
RouteSettings newSettings = RouteSettings(name: 'new name', arguments: oldSettings.arguments);
Timeline
#
Landed in version: 3.5.0-9.0.pre-137-gc6f6095acd
In stable release: 3.7
References
#Relevant PRs:
- PR 113860: Removes RouteSetting.copyWith.
Unless stated otherwise, the documentation on this site reflects Flutter 3.35.5. Page last updated on 2025-10-28. View source or report an issue.