第132期:flutter的导航和路由

2023-02-25 17:06:13 浏览数 (2)

导航和路由

Flutter提供了一个完整的用于在屏幕之间导航和处理深层链接的系统。没有复杂深度链接的小型应用程序可以使用Navigator,而具有特定深度链接和导航要求的应用程序也应该使用Router来正确处理AndroidiOS应用上的深度链接,并在应用程序在web上运行时与地址栏保持同步。

使用Navigator导航

Navigator导航组可以用正确的过渡动画来展示对应的界面,当然,和web端的路由类似,界面其实也是以的形式保存着。

通过路由的buildContext上下文,并且调用对应的push()pop()方法,我们就可以导航到新的界面,比如:

代码语言:javascript复制
onPressed: () {
  Navigator.of(context).push(
    MaterialPageRoute(
      builder: (context) => const SongScreen(song: song),
    ),
  );
},
child: Text(song.name),

由于Navigator保存了一个Route对象的堆栈(表示历史堆栈),所以push()方法也使用Route对象作为参数。MaterialPageRoute对象是Route的子类,用于指定Material Design的过渡动画。

命名路由

对于有些具有简单导航和深度链接需求的应用程序,我们可以使用Navigator进行导航,使用MaterialApp对象的routes属性对路由进行配置:

代码语言:javascript复制
@override
  Widget build(BuildContext context) {
  return MaterialApp(
    routes: {
      '/': (context) => HomeScreen(),
      '/details': (context) => DetailScreen(),
    },
  );
}

我们在这里配置的路由就是命名路由

命名路由的局限

尽管命名路由可以处理深层链接,但是他们的表现总是一致的,没办法做到自定义。当应用平台接收到一个新的深层链接,不论用户此时在哪个位置,Flutter都会将新的路线推送到导航器上。

使用命名路由的Flutter应用也不支持浏览器的前进按钮。基于这些原因,官方其实是不建议在大多数应用中使用命名路由。

当然,实际开发过程中,我们需要根据实际情况进行调整。

使用路由Router

具有高级导航和路由要求的Flutter应用程序(例如使用到每个屏幕的直接链接的web应用程序,或具有多个,或者嵌套导航Navigator组件的应用程序)应使用诸如go_router之类的路由包,该包可以在应用程序收到新的深度链接时解析路由路径并配置Navigator

要使用路由,我们需要切换到MaterialAppCupertino App上的路由器构造函数,并为其提供路由器配置。

代码语言:javascript复制
MaterialApp.router(
  routerConfig: GoRouter(
    // …
  )
);

由于像go_router这样的包是声明性的,所以当接收到深度链接时,它们将始终显示相同的界面。

同时使用RouterNavigator

RouterNavigator在设计时就可以协同工作。我们可以使用像go_router这样的路由包的 API进行路由的跳转,也可以使用Navigatorpush()pop()方法进行导航。

当我们使用Router或声明性路由包进行导航时,Navigator上的每个路由页面都是支持的。这表示,路由是根据页面上的使用了页面上参数的Navigator构造函数创建的路由。

相反,通过调用Navigator.push()等方法的路由导航,将会在导航中添加一个pageless(无页面)的路由。如果我们使用的是路由包,则页面支持的路由始终是可深度链接的,而无页面的路由则不是。

当从导航器中删除页面支持的路由时,它之后的所有无页面路由也将被删除。例如,如果深度链接通过从导航器中删除页面支持的路由来导航,则之后(直到下一个_pagebacked路由)的所有无页面路由也将被删除。

深度链接 Deep linking

Flutter支持iOS、Android和web浏览器上的深度链接。打开URL会在应用程序中显示该屏幕。通过以下步骤,我们可以使用命名路由(使用routes参数或onGenerateRoute)或使用Router小部件启动和显示路由。

如果我们在web浏览器中运行应用程序,则无需额外设置。路由路径的处理方式与iOS或Android深度链接相同。默认情况下,web应用程序使用模式:/#/path/to/app/screen从url片段读取深度链接路径,但这可以通过配置应用程序的url策略来更改。

在 Android 上启用 深度链接 Deep linking

只需要在AndroidManifest.xml配置文件中的<activity>标签中添加一个元数据标签和意向过滤器标签即可:

代码语言:javascript复制
<!-- Deep linking -->
<meta-data android:name="flutter_deeplinking_enabled" android:value="true" />
<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="http" android:host="flutterbooksample.com" />
    <data android:scheme="https" />
</intent-filter>

配置之后,重启整个应用即可。

在 ios 上启用 深度链接 Deep linking

需要在ios/Runner文件夹下Info.plist文件中添加两个新的key:

代码语言:javascript复制
<key>FlutterDeepLinkingEnabled</key>
<true/>
<key>CFBundleURLTypes</key>
<array>
    <dict>
    <key>CFBundleTypeRole</key>
    <string>Editor</string>
    <key>CFBundleURLName</key>
    <string>flutterbooksample.com</string>
    <key>CFBundleURLSchemes</key>
    <array>
    <string>customscheme</string>
    </array>
    </dict>
</array>

CFBundleURLName是一个唯一的URL,用于将我们的应用程序与其他使用相同方案的应用程序进行区分。

配置完成后,同样需要进行应用的重启。

在web上配置URL策略

flutter web 应用支持两种URL策略:

  • hash模式。如:flutterexample.dev/#/path/to/screen.
  • path模式。如:lutterexample.dev/path/to/screen.

配置起来也很简单,从flutter_web_plugins插件库导入usePathUrlStrategy方法,在入口函数中调用即可。

代码语言:javascript复制
import 'package:flutter_web_plugins/url_strategy.dart';

void main() {
  usePathUrlStrategy();
  runApp(ExampleApp());
}

PathUrlStrategy使用历史API,这需要对web服务器进行额外配置,具体怎么配置,应该跟nginx相关~

最后

熟悉了导航和路由,再加深一下对组件里的理解记忆,后面熟悉一下接口请求的方式,基本上就可以开始做flutter应用的开发了~

0 人点赞