[GoRouter] option to override initial route set by platform

packages/go_router/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 10.2.1
+
+- Adds optional parameter `overridePlatformDefaultLocation` to override initial route set by platform.
+
 ## 10.2.0
 
 - Adds `onExit` to GoRoute.

packages/go_router/lib/src/router.dart

@@ -80,6 +80,7 @@ class GoRouter implements RouterConfig<RouteMatchList> {
     int redirectLimit = 5,
     bool routerNeglect = false,
     String? initialLocation,
+    this.overridePlatformDefaultLocation = false,
     Object? initialExtra,
     List<NavigatorObserver>? observers,
     bool debugLogDiagnostics = false,
@@ -91,6 +92,8 @@ class GoRouter implements RouterConfig<RouteMatchList> {
           initialExtra == null || initialLocation != null,
           'initialLocation must be set in order to use initialExtra',
         ),
+        assert(!overridePlatformDefaultLocation || initialLocation != null,
+            'Initial location must be set to override platform default'),
         assert(
             (onException == null ? 0 : 1) +
                     (errorPageBuilder == null ? 0 : 1) +
@@ -299,6 +302,15 @@ class GoRouter implements RouterConfig<RouteMatchList> {
   @override
   late final GoRouteInformationParser routeInformationParser;
 
+  /// When set to [true], the route returned by `getInitialRoute` will take precedence over the
+  /// platform's default initial location. This allows developers to control the starting route
+  /// of the application independently of the platform.
+  ///
+  /// Setting this parameter to [false] (default) will allow the platform's default initial
+  /// location to be used. It's advisable to only set this to true if you explicitly want to
+  /// ignore the platform's default initial location.
+  final bool overridePlatformDefaultLocation;
+
   /// Returns `true` if there is at least two or more route can be pop.
   bool canPop() => routerDelegate.canPop();
 
@@ -509,6 +521,11 @@ class GoRouter implements RouterConfig<RouteMatchList> {
   String _effectiveInitialLocation(String? initialLocation) {
     final String platformDefault =
         WidgetsBinding.instance.platformDispatcher.defaultRouteName;
+    if (overridePlatformDefaultLocation) {
+      // can force null check as it's already verified by
+      // asset() while initialization
+      return initialLocation!;
+    }
     if (initialLocation == null) {
       return platformDefault;
     } else if (platformDefault == '/') {

packages/go_router/pubspec.yaml

@@ -1,7 +1,8 @@
 name: go_router
 description: A declarative router for Flutter based on Navigation 2 supporting
   deep linking, data-driven routes and more
-version: 10.2.0
+version: 10.2.1
+
 repository: https://github.com/flutter/packages/tree/main/packages/go_router
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+go_router%22
 

packages/go_router/test/go_router_test.dart

@@ -4909,6 +4909,54 @@ void main() {
       expect(statefulWidgetKeyB.currentState?.counter, equals(1));
     });
   });
+
+  ///Regression tests for https://github.com/flutter/flutter/issues/132557
+  group('overridePlatformDefaultLocation', () {
+    test('No initial location provided', () {
+      expect(
+          () => GoRouter(
+                overridePlatformDefaultLocation: true,
+                routes: <RouteBase>[
+                  GoRoute(
+                    path: '/a',
+                    builder: (BuildContext context, GoRouterState state) =>
+                        const Placeholder(),
+                  ),
+                  GoRoute(
+                    path: '/b',
+                    builder: (BuildContext context, GoRouterState state) =>
+                        const Placeholder(),
+                  ),
+                ],
+              ),
+          throwsA(const TypeMatcher<AssertionError>()));
+    });
+    test('Test override using routeInformationProvider', () {
+      final String platformRoute =
+          WidgetsBinding.instance.platformDispatcher.defaultRouteName;
+      const String expectedInitialRoute = '/abc';
+      expect(platformRoute != expectedInitialRoute, isTrue);
+
+      final GoRouter router = GoRouter(
+        overridePlatformDefaultLocation: true,
+        initialLocation: '/abc',
+        routes: <RouteBase>[
+          GoRoute(
+            path: '/abc',
+            builder: (BuildContext context, GoRouterState state) =>
+                const Placeholder(),
+          ),
+          GoRoute(
+            path: '/bcd',
+            builder: (BuildContext context, GoRouterState state) =>
+                const Placeholder(),
+          ),
+        ],
+      );
+      expect(router.routeInformationProvider.value.uri.toString(),
+          expectedInitialRoute);
+    });
+  });
 }
 
 class TestInheritedNotifier extends InheritedNotifier<ValueNotifier<String>> {