README.zh.md

一个命令行工具，针对flutter web加载慢和缓存问题提供了一套解决方案。

功能

• 通过大文件分片和资源文件cdn化方式，优化flutter web页面加载慢问题。
• 通过资源文件hash化，解决浏览器强缓存导致功能无法更新问题。

开始

在工程的pubspec.yaml文件中添加flutter_web_optimizer插件

dev_dependencies:
  flutter_web_optimizer: ^1.4.0

用法

在项目的根目录下执行plugin命令和optimize命令

plugin 命令

plugin命令实现自动生成插件模板文件，可以在插件里面实现将资源文件上传至文件服务器上，例如腾讯的cos、阿里的oss；

flutter pub run flutter_web_optimizer plugin --path scripts/test_plugin.dart

• path参数必传，指自定义plugin文件的位置。

optimize 命令

optimize命令针对flutter build web的打包产物作了大文件分片下载、资源文件hash化和资源文件cdn化三个优化。

flutter pub run flutter_web_optimizer optimize --asset-base http://192.168.101.93:9091/app/ --plugin scripts/test_plugin.dart

or

flutter pub run flutter_web_optimizer optimize --asset-base http://192.168.101.93:9091/app/ --plugin flutter_web_cos_upload_plugin

• asset-base参数必传，一般是文件服务器上存储对应资源文件的地址，地址必须是/结尾
• web-output参数非必传，指flutter web build的打包产物的文件夹位置，以当前命令行窗口为根路径，默认是build/web。
• plugin参数非必传，若需要将资源文件上传至服务器，则必传。该参数支持文件模式和插件模式两种模式，
  • 文件模式：指插件的文件位置，以当前命令行窗口为根路径。cos_upload_plugin.dart 文件已经实现了一套将资源文件上传至腾讯的cos的功能，可以参考。
  • 插件模式：指插件的名称，用法参考flutter_web_cos_upload_plugin 插件
• --enable-pwa参数非必传，指 PWA service worker，默认是true
• --hash-filter-regexp参数非必传，当进行hash文件操作时提供正则过滤
• --enable-vconsole参数非必传，指启用vconsole工具，默认是false