脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → Android → Flutter Fluro

Flutter路由框架Fluro使用教程详细讲解

 更新时间：2022年10月26日 09:42:27   作者：唯鹿  
在Flutter应用开发过程中，除了使用Flutter官方提供的路由外，还可以使用一些第三方路由框架来实现页面管理和导航，Fluro作为一款优秀的Flutter企业级路由框架，Fluro的使用比官方提供的路由框架要复杂一些，但是却非常适合中大型项目

1.Navigator使用简介

使用Flutter 的Navigator 导航器可以实现页面的跳转，Navigator的使用方法简单介绍一下：

页面跳转：

	Navigator.push<void>(
      context,
      MaterialPageRoute(
        builder: (BuildContext context) => const MyHomePage(),
      ),
    );

页面跳转的同时关闭当前页面（页面替换）:

	Navigator.pushReplacement<void, void>(
      context,
      MaterialPageRoute(
        builder: (BuildContext context) => const MyHomePage(),
      ),
    );

页面跳转的同时关闭到之前的某一个页面:

	Navigator.pushAndRemoveUntil<void>(
      context,
      MaterialPageRoute(
        builder: (BuildContext context) => const MyHomePage(),
      ), 
      (route) => false // ModalRoute.withName('/')
    );

也可以直接使用路由名称进行上面操作，例如跳转：Navigator.pushNamed(context, '/home');路由名称需要提前在MaterialApp中定义好。

	MaterialApp(
      title: 'Flutter Demo',
      home: MyHomePage(),
      routes: {
        "/page1": (context) => PageA(),
        "/page2": (context) => PageB(),
      },
    );

接收参数：var args = ModalRoute.of(context).settings.arguments;

页面返回

Navigator.pop(context);

接收页面的返回值：

	Navigator.push<void>(
      context,
      MaterialPageRoute(
        builder: (BuildContext context) => const MyHomePage(),
      ),
    ).then((dynamic result) {
      // 页面返回result
    });

必须同时配合Navigator.pop<dynamic>(context, result);

还有路由删除removeRoute，路由替换replace等。

2.fluro

直接使用Navigator的主要问题是不易维护。如果某个页面的传参发生了变化，那么所有跳转处都需要做修改。

所以我们可以使用现有封装好的路由框架来替我们解决这些问题。比如fluro。

1.配置

添加依赖至pubspec.yaml：

dependencies:
	fluro: ^2.0.3

定义唯一一个FluroRouter对象:

static final FluroRouter router = FluroRouter();

剩下的就是添加路由处理器Handler，下面代码举例添加了两个页面：

class Routes {
  static String home = '/home';
  static String webViewPage = '/webView';
  static final List<IRouterProvider> _listRouter = [];
  static final FluroRouter router = FluroRouter();
  static void initRoutes() {
    /// 指定路由跳转错误返回页
    router.notFoundHandler = Handler(
      handlerFunc: (BuildContext? context, Map<String, List<String>> params) {
        debugPrint('未找到目标页');
        return const NotFoundPage();
      });
    router.define(home, handler: Handler(
      handlerFunc: (BuildContext? context, Map<String, List<String>> params) => const Home()));
    // Routes.router.navigateTo(context, '${Routes.webViewPage}?title=标题&url=地址');
    router.define(webViewPage, handler: Handler(handlerFunc: (_, params) {
      /// 接收参数
      final String title = params['title']?.first ?? '';
      final String url = params['url']?.first ?? '';
      return WebViewPage(title: title, url: url);
    }));
  }
}

配置fluro：

	MaterialApp(
      onGenerateRoute: Routes.router.generator,
    );

初始化：

class MyApp extends StatelessWidget {
  MyApp() {
    Routes.initRoutes();
  }
  ...
}

2.使用方法

核心就一个方法navigateTo，源码如下：

  Future navigateTo(BuildContext context, String path,
      {bool replace = false,
      bool clearStack = false,
      bool maintainState = true,
      bool rootNavigator = false,
      TransitionType? transition,
      Duration? transitionDuration,
      RouteTransitionsBuilder? transitionBuilder,
      RouteSettings? routeSettings}) {
    RouteMatch routeMatch = matchRoute(context, path,
        transitionType: transition,
        transitionsBuilder: transitionBuilder,
        transitionDuration: transitionDuration,
        maintainState: maintainState,
        routeSettings: routeSettings);
    Route<dynamic>? route = routeMatch.route;
    Completer completer = Completer();
    Future future = completer.future;
    if (routeMatch.matchType == RouteMatchType.nonVisual) {
      completer.complete("Non visual route type.");
    } else {
      ///找不到时走`notFoundHandler`
      if (route == null && notFoundHandler != null) {
        route = _notFoundRoute(context, path, maintainState: maintainState);
      }
      if (route != null) {
        final navigator = Navigator.of(context, rootNavigator: rootNavigator);
        if (clearStack) {
          future = navigator.pushAndRemoveUntil(route, (check) => false);
        } else {
          future = replace
              ? navigator.pushReplacement(route)
              : navigator.push(route);
        }
        completer.complete();
      } else {
        final error = "No registered route was found to handle '$path'.";
        print(error);
        completer.completeError(RouteNotFoundException(error, path));
      }
    }
    return future;
  }
  • path:路由名称。
  • replace：等同于pushReplacement。
  • clearStack：等同于pushAndRemoveUntil。
  • transition:页面跳转动画，默认native，平台默认动画。
  • transitionDuration:动画时长。
  • transitionBuilder:自定义动画。
  • routeSettings:用于传递数据。可使用context.settings.arguments获取。

具体的使用见项目routers目录。

3.路由拦截

路由拦截可以实现权限控制。比如用户没有登录，当进入某些需要登录后才能显示的页面时，可以拦截跳转进行判断，引导用户进入登录页。

MaterialApp有 onGenerateRoute方法可以在跳转时进行路由拦截。但是使用的fluro将这一属性占用了，所以我们可以继承 FluroRouter 类，重写navigateTo方法实现。

class MyFluroRouter extends FluroRouter {
  List<String> _loginList;
  set loginList(value) => _loginList = value;
  @override
  Future navigateTo(
    BuildContext context,
    String path, {
    bool replace = false,
    bool clearStack = false,
    bool maintainState = true,
    bool rootNavigator = false,
    TransitionType transition,
    Duration transitionDuration,
    transitionBuilder,
    RouteSettings routeSettings,
  }) {
    String pathToNavigate = path;
    AppRouteMatch routeMatched = this.match(path);
    String routePathMatched = routeMatched?.route?.route;
    if (routePathMatched != null) {
      //如果页面需要登录，修改路由路径到登录页面
      if (_loginList != null && !_loginList.contains(routePathMatched)) {
        pathToNavigate = '/login‘;
      }
    }
    return super.navigateTo(context, pathToNavigate,
        replace: replace,
        clearStack: clearStack,
        maintainState: maintainState,
        rootNavigator: rootNavigator,
        transition: transition,
        transitionDuration: transitionDuration,
        transitionBuilder: transitionBuilder,
        routeSettings: routeSettings);
  }
}

3.封装

fluro工具类：

class NavigatorUtils {
  static void push(BuildContext context, String path,
      {bool replace = false, bool clearStack = false, Object? arguments}) {
    unfocus();
    Routes.router.navigateTo(context, path,
      replace: replace,
      clearStack: clearStack,
      transition: TransitionType.native,
      routeSettings: RouteSettings(
        arguments: arguments,
      ),
    );
  }
  static void pushResult(BuildContext context, String path, Function(Object) function,
      {bool replace = false, bool clearStack = false, Object? arguments}) {
    unfocus();
    Routes.router.navigateTo(context, path,
      replace: replace,
      clearStack: clearStack,
      transition: TransitionType.native,
      routeSettings: RouteSettings(
        arguments: arguments,
      ),
    ).then((Object? result) {
      // 页面返回result为null
      if (result == null) {
        return;
      }
      function(result);
    }).catchError((dynamic error) {
      debugPrint('$error');
    });
  }
  /// 返回
  static void goBack(BuildContext context) {
    unfocus();
    Navigator.pop(context);
  }
  /// 带参数返回
  static void goBackWithParams(BuildContext context, Object result) {
    unfocus();
    Navigator.pop<Object>(context, result);
  }
  static void unfocus() {
    FocusManager.instance.primaryFocus?.unfocus();
  }
}

模块管理：

import 'package:fluro/fluro.dart';
abstract class IRouterProvider {
  void initRouter(FluroRouter router);
}

实现接口：

class LoginRouter implements IRouterProvider{
  static String loginPage = '/login';
  static String registerPage = '/login/register';
  @override
  void initRouter(FluroRouter router) {
    router.define(loginPage, handler: Handler(handlerFunc: (_, __) => const LoginPage()));
    router.define(registerPage, handler: Handler(handlerFunc: (_, __) => const RegisterPage()));
  }
}

各模块初始化，放在Routes的initRoutes中：

    /// 各自路由由各自模块管理，统一在此添加初始化
    _listRouter.add(LoginRouter());
  	...
    /// 初始化路由
    void initRouter(IRouterProvider routerProvider) {
      routerProvider.initRouter(router);
    }
    _listRouter.forEach(initRouter);

目前Flutter团队有维护一款路由框架go_router（支持Navigator 2.0），但目前有部分功能缺失，比如不支持接收页面的返回值，没有pushAndRemoveUntil方法。

期待后面功能的完善。但就目前来说，对于Android 和iOS平台开发来说fluro的功能足够使用了。

到此这篇关于Flutter路由框架Fluro使用教程详细讲解的文章就介绍到这了,更多相关Flutter Fluro内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

相关文章

  • Android实现水波纹点击效果

    Android实现水波纹点击效果

    这篇文章主要为大家详细介绍了Android实现水波纹点击效果，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
    2017-03-03
  • Android仿贴吧内容下的简单ListView嵌套GridView

    Android仿贴吧内容下的简单ListView嵌套GridView

    这篇文章主要为大家详细介绍了Android仿贴吧内容下的简单ListView嵌套GridView，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
    2017-03-03
  • Android中网络框架简单封装的实例方法

    Android中网络框架简单封装的实例方法

    在本篇文章里小编给大家整理的是关于Android中网络框架简单封装的实例方法，需要的朋友们可以学习下。
    2020-03-03
  • Android辅助权限的介绍和配置完整记录

    Android辅助权限的介绍和配置完整记录

    这篇文章主要给大家介绍了关于Android辅助权限的介绍和配置的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2019-01-01
  • 深入解析Android中的事件传递

    深入解析Android中的事件传递

    这篇文章主要介绍了关于Android中的事件传递，文中介绍的非常详细，相信对大家具有一定的参考价值，需要的朋友们下面来一起看看吧。
    2017-03-03
  • kotlin实现语音聊天机器人案例详解

    kotlin实现语音聊天机器人案例详解

    Android智能问答机器人是时下非常流行的一种服务，微软“小冰”的出现更是让其实实在在的风靡了一把。那么，本文章就将带领大家完整的实现整个问答机器人的制作
    2023-02-02
  • Android自定义View中attrs.xml的实例详解

    Android自定义View中attrs.xml的实例详解

    这篇文章主要介绍了Android自定义View中attrs.xml的实例详解的相关资料,在自定义View首先对attrs.xml进行布局的实现及属性的应用，需要的朋友可以参考下
    2017-07-07
  • android相册选择图片的编码实现代码

    android相册选择图片的编码实现代码

    本篇文章主要介绍了android相册选择图片的编码实现代码，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
    2017-08-08
  • Android使用GridView实现表格分割线效果

    Android使用GridView实现表格分割线效果

    这篇文章主要为大家详细介绍了Android使用GridView实现表格分割线效果，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
    2020-07-07
  • Android二级缓存加载图片实现照片墙功能

    Android二级缓存加载图片实现照片墙功能

    这篇文章主要为大家详细介绍了Android二级缓存加载图片实现照片墙功能，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
    2017-07-07

最新评论