Flutter Web避坑指南

1.前言

上一篇文章《Flutter Web从0到部署上线的实践》https://www.jianshu.com/p/e610239e7e9c讲述了我们如何使用Flutter进行web开发,并最终打包上线的流程。本文将针对实际项目中遇到的一些问题进行说明。包含如下几个问题:

  • DartintJSNumber的转换问题。
  • 导入特定平台依赖项。
  • 路由问题。

接下来我会针对这几个问题一一进行说明。

2.Dart中int和JS中Number的转换

由于我们的项目是将一个线上的FlutterApp项目直接打包成web版,在运行的时候发现,我们发送的请求时常返回错误的数据,比如说:

我们请求了一个feed列表,然后点击某一个item进入详情页。

这时候列表都能正常的展示,但进入详情页服务端会报错:

不存在这个feed

通过跟服务端同学的沟通发现,出错的原因是在进入详情页请求feed详情时带的id错了。
这怎么会???id都是列表接口给的,web端也不会做任何处理进详情页直接带过去,而且线上App都是好好的也没有bug啊。
经过排查发现,id定义的是int类型,在Dart中,只有intdouble这两种表达数字的数据类型,其中int的取值范围是-2^63 ~ 2^63 - 1,可以同等于Java中的Long
在打包成web版式,Dart中的int会被编译成JS中的Number,问题就出在这儿了。Number的取值范围是-2^53 ~ 2^53 - 1。很不幸,我们模型中一些的id的取值范围大于2^53 - 1,从而转换成JSNumber后出错了。
原因找出来了,解决方法也显而易见了:
这种可能会超出JS取值范围的字段,需要改成String类型。
修改完后,这个问题顺利解决。

2.导入特定平台依赖项

在使用Flutter进行web端开发的时候,我们会经常使用dart:html这个库来实现一些功能。在仅仅打包web端时没问题,但由于我们的项目是跨平台的,打包App时就会出现以下问题:

截屏2023-08-04 11.49.51.png

是因为dart:html这个库只在web环境下能找得到,而编译App时并没有这个包,那也就意味着我们只能在web打包时使用dart:html这个库。解决方法如下:

import 'dart:html' if (dart.library.io) 'io_platform.dart' as platform;

import的时候需要区分平台,dart.library.io意味着是在非web环境下(dart:io不支持web)。所以在非web环境下我们import的是io_platform.dart这个文件。这时候我们有个疑问,非web环境下不引入dart:html不就好了么?为什么要引入另一个文件呢?原因是因为编译的时候还是会找相应的方法,我们没有引入任何库,导致相应的代码编译不过,所以我们自己创建了一个io_platform.dart文件,去实现相应的接口。当然由于这些方法不会被调用到,其实只是个空实现。
比方说我们现在用到了dart:html以下的方法和变量:

platform.window.navigator.userAgent; //navigator.userAgent
platform.window.location.origin; //location.origin
platform.window.location.href; //location.href
platform.window.open(url, ""); //open(String, String)

于是我们的io_platform.dart是这么实现的:

IoPlatformWindow get window => IoPlatformWindow();

class IoPlatformWindow {
  IoNavigator navigator = IoNavigator();
  IoLocation location = IoLocation();

  open(String url, String name) {}
}

class IoNavigator {
  String userAgent = "";
}

class IoLocation {
  String origin = "";
  String href = "";
}

实际上只是为了解决编译的问题。如果大家有更好的方式解决这个问题请给我留言哈。
最后我们再来看路由问题。

3.路由问题

我们知道常规web端开发时,进行页面跳转传参是靠在url上拼参数,如:

YOUR_HOST_NAME/PATH?feedId=123

但显然Flutter并不是这么传参的。比方说我们进入一个详情页,那么它的路由就是:YOUR_HOST_NAME/#detailPage,而参数并不可见。这样的话在我们刷新页面的时候,也拿不到参数自然会出现问题。
解决方法呢,比如说可以在LocalStorage里记录参数信息,然后做一个工具类去记录路由栈。但这也有问题,因为我们可以复制任意链接分享给别人,那么别人打开的时候本地没有记录自然也就无法正常打开页面。这种情况下甚至无法引导用户去首页。既然如此,那我们干脆处理成用户在刷新的时候,重新将网页指定到首页url

  void register() {
    if (platform.window.location.href !=
        platform.window.location.origin + "/" &&
        platform.window.location.href !=
            platform.window.location.origin + "/#/") {
      platform.window.location.href = platform.window.location.origin + "/";
    }
  }

在发现网页url不是首页的情况下,强制将href处理到首页。
然后在runApp(const MyApp());MyApp控件的initState()方法中调用register()。当然这一定不是最好的方法,但考虑到目前的状况,这样处理是最合适的。如果大家有别的处理方式也欢迎分享给我。

4.总结

Flutter Web确实还没那么完美,之前很多文章分享的延迟组件分包以减小main.dart.js大小的方式貌似也不可用了(官网明确说明是给AndroidAAB来使用的)。但有总比没有强,毕竟重新开发一个web版的App功能也挺大的,目前继续等着Flutter的更新,看看未来会不会有更好的支持。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,542评论 6 504
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,822评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,912评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,449评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,500评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,370评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,193评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,074评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,505评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,722评论 3 335
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,841评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,569评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,168评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,783评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,918评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,962评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,781评论 2 354

推荐阅读更多精彩内容