Add tab history option and browser history back/forward support (tomg…

…ilder#209)

CHANGELOG.md

@@ -1,4 +1,17 @@
-# 0.10.0-dev3
+# 0.10.0-dev4
+
+**Important:** this release has some major breaking changes with how Routemaster
+interacts with the system back button on Android and web.
+
+* Minimum supported Flutter version is now 2.5.0.
+
+* Breaking change: by default, the Android system back button now navigates
+  backwards chronologically, instead of just popping the navigation stack.
+
+* Breaking change: by default, tabs no longer add an entry to the web history
+  stack. This means the browser back button will not navigate between tabs.
+  To use the previous behavior, specify `backBehavior: TabBackBehavior.history` in
+  the tab page's constructor.
 
 * Added: `history` property on `Routemaster` for chronological history navigation,
   for example `Routemaster.of(context).history.back()`.

README.md

@@ -12,7 +12,7 @@ Hello! Routemaster is an easy-to-use router for Flutter, which wraps over Naviga
 * Really easy nested navigation support for tabs
 * Multiple route maps: for example one for a logged in user, another for logged out
 * Observers to easily listen to route changes
-* Covered by over 200 unit, widget and integration tests
+* Covered by over 250 unit, widget and integration tests
 
 Here's the entire routing setup needed for an app featuring tabs and pushed routes:
 

example/book_store/ios/Flutter/AppFrameworkInfo.plist

@@ -21,6 +21,6 @@
   <key>CFBundleVersion</key>
   <string>1.0</string>
   <key>MinimumOSVersion</key>
-  <string>8.0</string>
+  <string>9.0</string>
 </dict>
 </plist>

example/book_store/test/navigation_test.dart

@@ -6,7 +6,6 @@ import 'package:book_store/models.dart';
 import 'package:book_store/search_page.dart';
 import 'package:book_store/wishlist_page.dart';
 import 'package:flutter/cupertino.dart';
-import 'package:flutter/material.dart';
 import 'package:flutter_test/flutter_test.dart';
 import 'helpers.dart';
 

example/mobile_app/lib/main.dart

@@ -88,6 +88,7 @@ RouteMap _buildRouteMap(AppState appState) {
               '/notifications',
               '/settings',
             ],
+            backBehavior: TabBackBehavior.none,
           ),
       '/feed': (_) => MaterialPage(
             name: 'Feed',

example/mobile_app/test/feed_test.dart

@@ -52,7 +52,7 @@ void main() {
       await tester.pump();
       expect(systemUrl.current, '/feed/profile/1/photo');
 
-      await invokeSystemBack();
+      await tester.tap(find.byType(BackButton));
       await tester.pumpAndSettle();
       expect(systemUrl.current, '/feed/profile/1');
 
@@ -112,7 +112,7 @@ void main() {
       );
 
       // Goes back to profile
-      await invokeSystemBack();
+      await tester.tap(find.byType(BackButton));
 
       await tester.pump();
       await tester.pump(Duration(seconds: 1));
@@ -122,7 +122,7 @@ void main() {
       expect(find.byType(PhotoPage), findsNothing);
 
       // Goes back to feed home
-      await invokeSystemBack();
+      await tester.tap(find.byType(BackButton));
       await tester.pumpAndSettle();
       expect(systemUrl.current, '/feed');
     });
@@ -150,7 +150,7 @@ void main() {
 
     expect(find.text('Non-Page route'), findsOneWidget);
 
-    await invokeSystemBack();
+    await tester.tap(find.byType(BackButton));
     await tester.pump();
     await tester.pump(Duration(seconds: 1));
 

example/mobile_app/test/replace_test.dart

@@ -1,5 +1,7 @@
+import 'package:flutter/material.dart';
 import 'package:flutter_test/flutter_test.dart';
 import 'package:mobile_app/main.dart';
+import 'package:mobile_app/pages/feed_page.dart';
 import 'helpers.dart';
 
 Future pumpBottomNavigationPage(WidgetTester tester) async {
@@ -28,9 +30,10 @@ void main() {
       await tester.pump(Duration(seconds: 1));
       expect(systemUrl.current, '/bottom-navigation-bar/one');
 
-      await invokeSystemBack();
+      await tester.tap(find.byType(BackButton));
       await tester.pump();
       await tester.pump(Duration(seconds: 1));
+      expect(find.byType(FeedPage), findsOneWidget);
       expect(systemUrl.current, '/feed');
     });
   });