Flutter Web 加载优化:资源交付与延迟加载

从旧站的两次优化实践出发,说明字体、资源交付、按需加载和跨浏览器取舍。

适用版本

合并 2022 年两篇记录;原环境包含 Flutter 3.4.0 beta,不沿用旧渲染器参数。

本文目录
  1. 先分清下载和渲染
  2. 用 deferred 延后非首屏模块
  3. 字体与资源按用途安排
  4. 保留当时的取舍,区分现在的配置
  5. 参考

2022 年的旧站经历了两次 Flutter Web 加载优化:第一次集中在字体与 CanvasKit 资源下载,第二次尝试延迟加载,并比较当时 HTML 与 CanvasKit 渲染器的取舍。

这些记录保留了定位问题的方法。原文的加载秒数没有统一的设备、网络和测量条件,不能直接用来承诺当前项目的性能。

先分清下载和渲染

首次加载涉及 HTML、启动脚本、编译产物、字体、图片以及渲染相关资源。某个 CDN 很慢、首屏一次加载过多页面、字体缺失,都可能让用户感觉页面长时间没有准备好。

原站将渲染资源放到自己的服务器,并配置项目字体,分别处理下载来源和文字显示问题。文章关闭后,原来的 neverouo.xyz/canvaskit/ 也不应继续成为其他应用的资源依赖。

原记录:字体与资源配置

原记录:首次加载过程

用 deferred 延后非首屏模块

Dart 的 deferred import 可以在 Web 上按需加载库。原站把并非首屏需要的工具页单独延迟导入,在用户真正打开时再调用 loadLibrary()。

dart
import 'tool_page.dart' deferred as tool_page;

class ToolRoute extends StatefulWidget {
  const ToolRoute({super.key});

  @override
  State<ToolRoute> createState() => _ToolRouteState();
}

class _ToolRouteState extends State<ToolRoute> {
  late final Future<void> _load = tool_page.loadLibrary();

  @override
  Widget build(BuildContext context) {
    return FutureBuilder<void>(
      future: _load,
      builder: (context, snapshot) {
        if (snapshot.hasError) {
          return const Center(child: Text('页面加载失败,请重新打开'));
        }
        if (snapshot.connectionState != ConnectionState.done) {
          return const Center(child: CircularProgressIndicator());
        }
        return tool_page.ToolPage();
      },
    );
  }
}

Future 保存在 State 中,避免每次 build 都重新创建加载流程。工具页和它的重依赖也不能同时从其他首屏路径被直接引用,否则按需加载的收益会减少。

这里展示 Web 库延迟加载。旧文的 pubspec deferred-components 配置属于另一层平台机制,不作为 Web 的必需配置保留。

原记录:延迟加载后的网络资源变化

字体与资源按用途安排

yaml
flutter:
  fonts:
    - family: ProjectText
      fonts:
        - asset: assets/fonts/project-text.ttf

字体声明与 ThemeData 中使用的 fontFamily 保持一致。先加载首屏真正需要的字体与图片,大图和非首屏内容按需请求。字体授权和文件体积也会影响发布方式。

把资源放到自有域名能减少对外部下载地址的依赖,但需要与部署版本配套处理缓存和更新;资源可访问不等于首屏性能已经改善。

保留当时的取舍,区分现在的配置

原文在 Flutter 3.4.0 beta 背景下尝试 HTML 渲染器,观察到桌面加载变快,同时遇到部分 iPhone Safari 刷新异常,随后又转回 CanvasKit。这是当时多浏览器体验之间的取舍。

当前 Flutter Web 官方说明使用 CanvasKit 和 Skwasm。旧文章中的 --web-renderer html、旧 PWA 参数及固定 CanvasKit 下载地址不再作为当前构建指令展示。具体构建选项与项目 SDK 版本对应,延迟加载和控制首屏依赖的思路可以独立保留。

参考

作者:NeverOuO。原载 NeverOuO 个人小站,现收录于云屿来文章与教程。

返回全部文章

把好用的工具分享给朋友

分享

发送链接,让朋友直接打开这个页面。

访问统计

我们统计页面浏览、渠道来源、产品入口点击与分享次数,用于了解产品如何被发现。这项统计不使用用户标识、Cookie 或跨站追踪,也不读取上传文件或表单内容。