Flutter深入浅出组件篇---MaterialApp

Posted 2021-08-21 Jimi

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Flutter深入浅出组件篇---MaterialApp相关的知识，希望对你有一定的参考价值。

Flutter整体结构图

Flutter Framework

Foundation、Animation、Painting、Gestures被合成了一个Dart UI层，对应的是Flutter中 dart:ui 包，是Flutter引擎暴露的底层UI库，主要提供动画、手势、绘制能力。
Rendering层是一个抽象布局层，依赖于Dart UI层，Rendering层会构建一个UI树、当UI树有变化时，会计算出有变化的部分，然后更新UI树，最终绘制在屏幕上
Widgets层是Flutter提供的一套基础组件库
Material、Cupertino是Flutter提供了两种视觉风格的组件库（android、ios)
Flutter Engine
这是一个纯C++实现的SDK，主要执行相关的渲染、线程管理、平台事件等操作。其中包括了Skia引擎、Dart运行时、文字排版引擎等。在调用dart:ui库是，其实最终会走到Engine层，实现真正的绘制逻辑.
Flutter Embedder
提供四个Task Runner，将引擎一直到平台中间层代码的渲染设置、原生插件、打包、线程管理、时间循环、交互操作等。
UI Runner 负责绑定渲染相关操作
GPU Runner 用户执行GPU指令
iOS Runner 处理图片数据、为GPU做准备的
Platform Runner 所有接口调用都使用该接口
示例代码

本文中很多效果都没有截图，可下载源代码运行项目源代码地址，或者通过视频教程查看视频教程地址

Material介绍

Material 组件（MDC）帮助开发者实现 Material Design。MDC 由谷歌团队的工程师和 UX 设计师创造，为 Android、iOS、Web 和 Flutter 提供很多美观实用的 UI 组件。

MaterialApp介绍

MaterialApp 包含了许多的 Widget ，这些 Widget 通常是实现 Material Design 的应用程序所必须要的，包含的 Widget 可以在 Material Components widgets 中查看所有。
了解基本的概念，接下来我们详细看一下 MaterialApp 具体怎么使用。

Material属性和说明

总共33个属性

字段	属性	描述
navigatorKey	GlobalKey<NavigatorState>	导航键
scaffoldMessengerKey	GlobalKey<ScaffoldMessengerState>	脚手架键
home	Widget	主页，应用打开时显示的页面
routes	Map<String, WidgetBuilder>	应用程序顶级路由表
initialRoute	String	如果构建了导航器，则会显示第一个路由的名称
onGenerateRoute	RouteFactory	路由管理拦截器
onGenerateInitialRoutes	InitialRouteListFactory	生成初始化路由
onUnknownRoute	RouteFactory	当onGenerateRoute无法生成路由时调用
navigatorObservers	List<NavigatorObserver>	创建导航器的观察者列表
builder	TransitionBuilder	在导航器上面插入小部件
title	String	程序切换时显示的标题
onGenerateTitle	GenerateAppTitle	程序切换时生成标题字符串
color	Color	程序切换时应用图标背景颜色（仅安卓有效）
theme	ThemeData	主题颜色
darkTheme	ThemeData	暗黑模式主题颜色
highContrastTheme	ThemeData	系统请求“高对比度”使用的主题
highContrastDarkTheme	ThemeData	系统请求“高对比度”暗黑模式下使用的主题颜色
themeMode	ThemeMode	使用哪种模式的主题（默认跟随系统）
locale	Locale	初始区域设置
localizationsDelegates	Iterable<LocalizationsDelegate<dynamic>>	本地化代理
localeListResolutionCallback	LocaleListResolutionCallback	失败或未提供设备的语言环境
localeResolutionCallback	LocaleResolutionCallback	负责计算语言环境
supportedLocales	Iterable<Locale>	本地化地区列表
debugShowMaterialGrid	bool	绘制基线网格叠加层（仅debug模式）
showPerformanceOverlay	bool	显示性能叠加
checkerboardRasterCacheImages	bool	打开栅格缓存图像的棋盘格。
checkerboardOffscreenLayers	bool	打开渲染到屏幕外位图的层的棋盘格。
showSemanticsDebugger	bool	打开显示可访问性信息的叠加层
debugShowCheckedModeBanner	bool	调试显示检查模式横幅
shortcuts	Map<LogicalKeySet, Intent>	应用程序意图的键盘快捷键的默认映射。
actions	Map<Type, Action<Intent>>	包含和定义用户操作的映射
restorationScopeId	String	应用程序状态恢复的标识符
scrollBehavior	ScrollBehavior	可滚动小部件的行为方式

构造函数

创建一个MaterialApp

MaterialApp(...)

创建一个使用 Router 而不是 Navigator 的 MaterialApp

MaterialApp.router(...)

属性详解

1、navigatorKey

navigatorKey 相当于 Navigator.of(context) ，如果应用程序想实现无 context 跳转，那么可以通过设置该key, 通过 navigatorKey.currentState.overlay.context 获取全局context。

使用方法

GlobalKey<NavigatorState> _navigatorKey = GlobalKey();

MaterialApp(
  navigatorKey: _navigatorKey,
);

2、scaffoldMessengerKey

scaffoldMessengerKey 主要是管理后代的 Scaffolds，可以实现无 context 调用 snack bars

使用方法

GlobalKey<ScaffoldMessengerState> _scaffoldKey = GlobalKey();

MaterialApp(
  scaffoldMessengerKey: _scaffoldKey,
);

_scaffoldKey.currentState.showSnackBar(SnackBar(content: Text("show SnackBar")));

3、home

程序进入后的第一个界面，传入一个 Widget

使用方法

...
MaterialApp(
  home: Scaffold(...),
);
...

4、routes

生成路由表，以键值对形式传入 key 为路由名字， value 为对应的Widget

使用方法

MaterialApp(
  routes: {
    "/home": (_) => Home(),
    "/my": (_) => My()
    //....
  },
);

5、initialRoute

初始路由，如果设置了该参数并且在 routes 找到了对应的key，将会展示对应的 Widget ，否则展示 home

使用方法

 MaterialApp(
   routes: {
     "/home": (_) => Home(),
     "/my": (_) => My()
   },
   initialRoute: "/home",
 )

6、onGenerateRoute

当跳转路由时，如果在 routes 找不到对应的 key ，会执行该回调，会调用会返回一个 RouteSettings ，该对象中有 name 路由名称、 arguments 路由参数。

使用方法

 MaterialApp(
   routes: {
     "/home": (_) => Home(),
     "/my": (_) => My()
     },
   initialRoute: "/home",
   onGenerateRoute: (setting) {
     // 这里可以做进一步的逻辑处理
     return MaterialPageRoute(builder: (_) => Home());
   },
)

7、onGenerateInitialRoutes

如果提供了 initialRoute ，则用于生成初始路由的路由生成器回调，如果未设置此属性，则底层 Navigator.onGenerateInitialRoutes 将默认为 Navigator.defaultGenerateInitialRoutes。

使用方法

MaterialApp(
  initialRoute: "/home",
  onGenerateInitialRoutes: (initialRoute) {
    return [
      MaterialPageRoute(builder: (_) => Home()),
      MaterialPageRoute(builder: (_) => My()),
    ];
  }
 )

8、onUnknownRoute

效果和 onGenerateRoute 一样，只是先走 onGenerateRoute ，如果无法生成路由时则在调用 onUnknownRoute 。

使用方法

MaterialApp(
   routes: {
     "/home": (_) => Home(),
     "/my": (_) => My()
     },
   initialRoute: "/home",
   onGenerateRoute: (setting) {
     return null;
   },
   onUnknownRoute: (setting) {
     return MaterialPageRoute(builder: (_) => Home());
   },
)

9、navigatorObservers

路由监听器，主要是就是监听页面路由堆栈的变化，当页面进行 push pop remove replace 等操作时会进行监听。

使用方法

MaterialApp(
     navigatorObservers: [
    MyObserver()
  ],
)
  
 class MyObserver extends NavigatorObserver {
  @override
  void didPush(Route route, Route previousRoute) {
    print(route);
    print(previousRoute);
    super.didPush(route, previousRoute);
  }
}

10、builder

当构建 Widget 前调用，主要用于字体大小、主题颜色等配置

使用方法

MaterialApp(
   routes: {
     "/home": (_) => Home(),
     "/my": (_) => My()
     },
   initialRoute: "/home",
   onGenerateRoute: (setting) {
     return null;
   },
   onUnknownRoute: (setting) {
     return MaterialPageRoute(builder: (_) => Home());
   },
      builder: (_, child) {
     return Scaffold(appBar: AppBar(title: Text("build")), body: child,);
   },
)

11、title

Android：任务管理器的程序快照之上
IOS: 程序切换管理器中

使用方法

 MaterialApp(
   title: \'Flutter应用\',
 );

12、onGenerateTitle

如果非空，则调用此回调函数以生成应用程序的标题字符串，否则会使用 title 。每次重建页面是该方法就会回调执行。

使用方法

MaterialApp(
   title: \'Flutter应用\',
   onGenerateTitle: (_) {
     return "我的天";
   },
 );

13、color

设置该值的在程序切换时应用图标的背景颜色，当应用图标为透明时。

使用方法

MaterialApp(
  color: Colors.blue,
)

14、theme

如果指定了 darkTheme ，那么用于提供用户界面的深色版本。如果提供了 darkTheme ， themeMode 将控制将使用哪个主题。默认值是 ThemeData.light()
应用程序的主题颜色

使用方法

MaterialApp(
  theme: ThemeData(
    // 主要颜色
    primaryColor: Colors.red
  ),
)

15、darkTheme

应用程序深色主题颜色

使用方法

MaterialApp(
  theme: ThemeData(
    // 主要颜色
    primaryColor: Colors.red
  ),
)

16、highContrastTheme

当系统请求“高对比度”时使用的 ThemeData ，当该值为空时会用 theme 应用该主题

使用方法

MaterialApp(
  highContrastTheme: ThemeData(
    primaryColor: Colors.pink
  ),
)

17、highContrastDarkTheme

当系统再暗黑模式下请求“高对比度”时使用的 ThemeData ，当该值为空时会用 darkTheme 应用该主题。

使用方法

MaterialApp(
  highContrastDarkTheme: ThemeData(
    primaryColor: Colors.green
  ),
)

18、themeMode

白天模式和暗黑模式模式切换，默认值为 ThemeMode.system

使用方法

MaterialApp(
  themeMode: ThemeMode.dark
)

19、locale

主要用于语言切换时，如果为 null 时使用系统区域

使用方法

MaterialApp(
  locale: Locale(\'zh\', \'CN\') // 中文简体
)

20、localizationsDelegates

本地化委托

使用方法

MaterialApp(
  locale: Locale(\'zh\', \'CN\') // 中文简体
  localizationsDelegates: [
    GlobalMaterialLocalizations.delegate,
    GlobalWidgetsLocalizations.delegate,
  ],
)

21、supportedLocales

当前应用支持的 Locale 列表

使用方法

MaterialApp(
  locale: Locale(\'zh\', \'CN\'), // 中文简体
  supportedLocales: [
    Locale(\'en\', \'US\'), //美国英语
    Locale("zh", \'CN\'), //中文简体
  ]
)

22、localeListResolutionCallback

监听系统语言切换事件，一些安卓系统特性，可设置多语言列表，默认以第一个列表为默认语言

使用方法

MaterialApp(
  locale: Locale(\'zh\', \'CN\'), // 中文简体
  supportedLocales: [
    Locale(\'en\', \'US\'), //美国英语
    Locale("zh", \'CN\'), //中文简体
  ],
  localeListResolutionCallback: (List<Locale> locales, Iterable<Locale> supportedLocales) {
    // 系统切换语言时调用
    return Locale("zh", \'CN\');
  },
)

23、localeResolutionCallback

监听系统语言切换事件

使用方法

MaterialApp(
  locale: Locale(\'zh\', \'CN\'), // 中文简体
  supportedLocales: [
    Locale(\'en\', \'US\'), //美国英语
    Locale("zh", \'CN\'), //中文简体
  ],
  localeResolutionCallback: (Locale locale, Iterable<Locale> supportedLocales) {
    return Locale("zh", \'CN\');
  },
)

24、debugShowMaterialGrid

在 debug 模式下展示基线网格

使用方法

MaterialApp(
  debugShowMaterialGrid: true
)

25、showPerformanceOverlay

显示性能叠加，开启此模式主要用于性能测试

使用方法

MaterialApp(
  showPerformanceOverlay: true
)

26、checkerboardRasterCacheImages

打开栅格缓存图像的棋盘格

使用方法

MaterialApp(
  checkerboardRasterCacheImages: true
)

27、checkerboardOffscreenLayers

打开渲染到屏幕外位图的层的棋盘格

使用方法

MaterialApp(
  checkerboardOffscreenLayers: true
)

28、showSemanticsDebugger

打开显示可访问性信息的叠加层，展示组件之间的关系、占位大小

使用方法

MaterialApp(
  showSemanticsDebugger: true
)

29、debugShowCheckedModeBanner

调试显示检查模式横幅

使用方法

MaterialApp(
  debugShowCheckedModeBanner: false
)

30、shortcuts以及actions

shortcuts 和 actions 是将物理键盘事件绑定到用户界面中的操作。比如，要在您的应用程序中定义键盘快捷键，这里不做过多的描述，后面我会专门拿一个专题来讲解。

31、restorationScopeId

定义一个应用程序状态恢复的标识符，提供标识符会将 RootRestorationScope 插入 widget 层次结构，从而为后代 widget 启用状态恢复。还可以通过标识符使 WidgetsApp 构建的导航器恢复其状态（即恢复活动路由的历史堆栈），由于这里涉及的内容较多，后面会专门拿一个专题来讲解。

32、scrollBehavior

统一滚动行为设置，设置后子组件将返回对应的滚动行为

使用方法

MaterialApp(
  scrollBehavior: ScrollBehaviorModified()
)
  
class ScrollBehaviorModified extends ScrollBehavior {
  const ScrollBehaviorModified();
  @override
  ScrollPhysics getScrollPhysics(BuildContext context) {
    switch (getPlatform(context)) {
      case TargetPlatform.iOS:
      case TargetPlatform.macOS:
      case TargetPlatform.android:
        return const BouncingScrollPhysics();
      case TargetPlatform.fuchsia:
      case TargetPlatform.linux:
      case TargetPlatform.windows:
        return const ClampingScrollPhysics();
    }
    return null;
  }
}

以上是关于Flutter深入浅出组件篇---MaterialApp的主要内容，如果未能解决你的问题，请参考以下文章

Flutter（30）：Material组件之DataTable

Flutter 周刊 #001

flutter系列之:Material主题的基础-MaterialApp

如何将符合 Material Design 标准的填充应用到我的 Flutter Scaffold？

打造 Material 字体样式主题 | 实现篇

Flutter 基础组件之 Scaffold

Flutter深入浅出组件篇---MaterialApp

Flutter整体结构图

Flutter Framework

Flutter Engine

Flutter Embedder

示例代码

Material介绍

MaterialApp介绍

Material属性和说明

构造函数

创建一个MaterialApp

创建一个使用 Router 而不是 Navigator 的 MaterialApp

属性详解

1、navigatorKey

使用方法

2、scaffoldMessengerKey

使用方法

3、home

使用方法

4、routes

使用方法

5、initialRoute

使用方法

6、onGenerateRoute

使用方法

7、onGenerateInitialRoutes

使用方法

8、onUnknownRoute

使用方法

9、navigatorObservers

使用方法

10、builder

使用方法

11、title

使用方法

12、onGenerateTitle

使用方法

13、color

使用方法

14、theme

使用方法

15、darkTheme

使用方法

16、highContrastTheme

使用方法

17、highContrastDarkTheme

使用方法

18、themeMode

使用方法

19、locale

使用方法

20、localizationsDelegates

使用方法

21、supportedLocales

使用方法

22、localeListResolutionCallback

使用方法

23、localeResolutionCallback

使用方法

24、debugShowMaterialGrid

使用方法

25、showPerformanceOverlay

使用方法

26、checkerboardRasterCacheImages

使用方法

27、checkerboardOffscreenLayers

使用方法

28、showSemanticsDebugger

使用方法

29、debugShowCheckedModeBanner

使用方法

30、shortcuts以及actions

31、restorationScopeId

32、scrollBehavior

使用方法