专栏首页全栈前端精选从 Flutter Go 到 Flutter Go web - 手把手带你轻松玩转 Flutter-web(一)

从 Flutter Go 到 Flutter Go web - 手把手带你轻松玩转 Flutter-web(一)

背景

其实背景不多说, Flutter for WebGoogle大会 伴随 Flutter 发布了1.5.4版本,同时也推出了Flutter for Web的预览版。

从5月后到目前(9月)业内对于 Flutter for Web 的观点,也是喜忧参半。

目前官方自述的问题包括以下内容:

  • Flutter for Web 还没有插件系统。暂时提供访问dart:html,dart:js,dart:svg,dart:indexed_db,只能使用其他网络库访问的浏览器的API
  • Flutter for Web 不能实现Flutter所有的 Api
  • Flutter for web 生成的代码可能运行缓慢,或者显示重要的UI jank
  • 目前,桌面用户界面的互动并不齐全,因此 flutter_web 在PC浏览器上运行,运行的用户界面像手机APP一样
  • 开发工作流程目前仅适用于Chrome( 笔者的 Safari 浏览器(版本 12.1.1)运行正常)

尽管 Flutter for Web 还有这样或者那样的问题,但是还好他只是 预览版, 未来可期,毕竟 Google 还是有无限可能。同时笔者通过一些渠道了解到,Flutter for Web 年底还有大动作。

下面是 Flutter 官方的2019年,是“ Google的一个早期采用者计划 ”,其中提到: “ 优秀的候选人将参与到引人注目的场景中,计划在2019年底将有一个基于 Flutter web 的体验发布 ”。

前言

笔者所在的团队之前开发了 FLutter Go 这个“ 帮助 FLutter 开发者快速上手的 APP ”,受到了一些 Flutter 入门开发者的认可。如果不了解这个项目请移步到 这里。

FLutter Go 遇到Flutter for Web ,如同牛奶遇到咖啡,我们必须做点什么.

  • 第一:亲历Flutter for Web 到底如何;
  • 第二:为需要从Flutter nativeFlutter-web 的开发者,摸石头趟条路,毕竟从nativeweb,并不是一键生成的,还有许多坑要填。

Flutter-Go-Web支持尚不稳定。我们将此版本指定为技术预览版; 对 Flutter Go native 版本移植还原度大概在 80%左右。旨在帮助 Flutter 开发人员,快速熟悉 Flutter-web 官方的实践。

Flutter 官方宣布Flutter暂时不会开发热更新(Code push) 之后, Flutter-web 无疑是的动态更新代码最快捷的方式,虽然不是最佳方案,但是是最易用降级方案。

通过 Flutter-go-web 版本的学习,可以快速,有效还原 Flutter-go native 版本。帮助开发者,对快速版本H5化,做一个样例展示,提供 Flutter-web 的能力演示。

  • 线上展示地址
    • Flutter GO 官网
    • Flutter Go web 版本

准备

言归正传,开发前还是建议大家对 Flutter-web 有一个基本的了解。如果熟悉请忽略。

  • 请了解 Flutter-web 官方说明
  • 请了解 Flutter-web 的迁移指南

构建环境

1. 安装 flutter_web 构建工具

输入命令从 https://pub.dev 的镜像拉取 webdev程序,webdev 类似于前端的构建工具

$ flutter pub global activate webdev

确保 $HOME/.pub-cache/bin 这个环境变量存在,环境变量在 vim ~/.bash_profile 里修改

// ~/.bash_profile 加上这句
$ export PATH="$PATH":"$HOME/.pub-cache/bin"

2. 拉取 flutter_web 示例

Flutter-web版本都是基于,web版本的 packages 包,所以要另起一个新的工程。 为了避免创建的不一致性,基于官方的 flutter_web 示例做更改

$ git clone https://github.com/flutter/flutter_web.git flutter_go_web

3. 创建 flutter_go_web 项目

由于我们只有一个目标项目,所以可以删除 examples 目录,替换成 Flutter Go项目开发。

$ cd flutter_go_web
$ rm -rf examples

4. 手动创建 yaml 文件

在项目根目录,需要创建两个关键的 .yaml 文件 build.yaml 是发布版本的必要的配置 pubspec.yaml 是所有依赖配置,类似于 webpack 里的 package.json 这两个配置内容分别如下:

# build.yaml
targets:
  $default:
    builders:
      build_web_compilers|entrypoint:
        # Avoid building the test directory.
        generate_for: ['web/**.dart']
        options:
          dart2js_args:
            - --no-source-maps
            - -O4
            - --fast-startup
            - --minify
            - --trust-primitives
            - --trust-type-annotations
# pubspec.yaml
name: flutter_go
description: flutter_go
environment:
  # You must be using Flutter >=1.5.0 or Dart >=2.3.0
  sdk: '>=2.3.0-dev.0.1 <3.0.0'

dependencies:
  flutter_web: any
  flutter_web_ui: any

dev_dependencies:
  build_runner: any
  build_web_compilers: any
  build_daemon: any

# dependency_overrides 优先直接引用github上的packages
dependency_overrides:
  flutter_web:
    git:
      url: https://github.com/flutter/flutter_web
      path: packages/flutter_web
  flutter_web_test:
    git:
      url: https://github.com/flutter/flutter_web
      path: packages/flutter_web_test
  flutter_web_ui:
    git:
      url: https://github.com/flutter/flutter_web
      path: packages/flutter_web_ui

当然 dependency_overrides 你也可以配置成本地路径,但是为了保证依赖库的最新,还是用git上的比较好, 下面是本地路径的配置。

dependency_overrides:
  flutter_web:
    path: ./packages/flutter_web
  flutter_web_test:
    path: ./packages/flutter_web_test
  flutter_web_ui:
    path: ./packages/flutter_web_ui

5. 更新 packages

$ flutter pub upgrade
! flutter_web 0.0.0 from path packages/flutter_web
! flutter_web_ui 0.0.0 from path packages/flutter_web_ui
Running "flutter pub upgrade" in hello_world... 5.0s

6. 拷贝 Flutter-go 项目下的 libs 到Flutter_go_web 目录下

7. 现在就可以使用 webdev 构建并启动开发服务器

$ webdev serve
或者 webdev 与热重载一起使用
$ webdev serve --auto restart
[INFO] Reading cached asset graph completed, took 598ms
[INFO] Checking for updates since last build completed, took 2.1s
[INFO] Starting resource servers...

之后提示一直在连接中, 说明 缺少 resource 资源文件,继续下面操作

8. 创建 web 入口

手动创建 web 文件夹,里面创建两个文件: index.html 为入口 html 页面 main.darthtml 引用文件

<!-- index.html-->
<!DOCTYPE html>
<html lang="en">
	<head>
	  <meta charset="UTF-8">
	  <title></title>
	  <script defer src="main.dart.js" type="application/javascript"></script>
	</head>
	<body>
	</body>
</html>
/// main.dart
import 'package:flutter_web_ui/ui.dart' as ui;
/// flutter_go 是项目名称,在pubspec.yaml 里已经设置
import 'package:flutter_go/main.dart' as app;
main() async {
  await ui.webOnlyInitializePlatform();
  app.main();
}

文件目录结构基本已经成型,如下:

9. 再次运行 webdev 编译并启动开发服务器

$ webdev serve --auto restart

本地服务器这样就能跑起来了!?先别忙,接下来报了如下一堆错误 ...

基本是依赖的 `Flutter-web`的核心库和第三方库,核心库需要替换的依赖大概如下:

package:flutter/material.dart -> package:flutter_web/material.dart
package:flutter/widgets.dart -> package:flutter_web/widgets.dart
package:flutter/cupertino.dart -> package:flutter_web/cupertino.dart
package:flutter/services.dart -> package:flutter_web/services.dart
package:flutter/rendering.dart -> package:flutter_web/rendering.dart
package:flutter/gestures.dart -> package:flutter_web/gestures.dart
dart:ui -> package:flutter_web_ui/ui.dart

你可以一个个文件替换,不过笔者写了一个转换库trans2fw小工具,用一个命令就可以对【官方常用的代码库】转换成web版本,减少大家的开发成本。 trans2fw 是笔者开发的一个 自动化 flutter native 项目转化成 flutter-web 项目的工具,已经提交到 pub 镜像上。github 地址>>>

  • 安装 trans2fw 工具, 并注册程序
  $ pub global activate trans2fw
  $ pub global run trans2fw
  • 运行 trans2fw 工具,根据提示输入,安装完成后,基本按提示输入转换目录就可以了
$ trans2fw
[✓] 请输入需要转换的文件目录(相对于项目目录): lib
[✓] 是否覆盖原有文件 ?  (y/N) y
{path: lib, cover: true}
使用输入文件目录:lib
被转换的文件::lib/routers/application.dart::4
被转换的文件::lib/routers/routers.dart::4
被转换的文件::lib/routers/router_handler.dart::4
被转换的文件::lib/resources/icon_names.dart::3
被转换的文件::lib/resources/shared_preferences_keys.dart::3
被转换的文件::lib/resources/widget_name_to_icon.dart::3
被转换的文件::lib/standard_pages/index.dart::6
...

稍等片刻 ... 见证奇迹

10. 再次运行 webdev 编译并启动开发服务器

$ webdev serve --auto restart

what c... is your problem ?! 还有这么多... 别着急再仔细看,剩下的都是第三方库的依赖问题! 如果你自己的项目没有过大量的第三方库,也许已经运行起来了。 不要紧,咱们逐个解决。

解决第三方库

总结一下都有哪些第三方库需要搞定:

  • fluro
  • flutter_jpush
  • flutter_spinkit
  • event_bus
  • share
  • shared_preferences
  • zefyr
  • image_picker
  • sqflite
  • url_launcher
  • flutter/foundation
  • flutter_webview_plugin
  • flutter_bloc
  • bloc
  • dio
  • city_pickers
  • markdown
  • path_provider
  • cookie_jar
  • sqflite

真的好多,怎么办,Google 大法 留的坑,目前只能自力更生了。 写到这里一看 iwatch ⌚️,已经凌晨了,一声感叹 "哎我去" ... 篇幅有限,这些个问题我会在《从 Flutter Go 到 Flutter Go web - 手把手带你轻松玩转 Flutter-web(二)》做解答,如有兴趣想知道我如何解决的,敬请继续关注。

以上的案例的github地址>>>

最后

沉淀了数月,FlutterGo 终于迎来了第二次迭代更新!不仅新增个人中心的概念,还提供了第三方共建工具、并且,我们还完成了 FlutterGo web 版的开发。而这些~都在我们FlutterGo官网可见!!!

相关介绍

? Flutter Go 2.0 即将发布

Flutter Go 2.0 秉承年初发布的 The Flutter-Go Roadmap(路线图) for 2019 已经做了新版本的迭代,新版本如下新功能:

注:✔是本次发布内容
  • Flutter Go 官方网站 (官方消息,发布,学习)
  • Flutter Go web 版本 (web 版本学习帮助)
    • 线上预览版
    • 项目地址
  • Flutter Go Widgetpull request 提交规范(第三方共建)
  • 用户中心 (专属个人的widget案例)
    • 用户登录(通过GitHub账户)
    • 全网搜索 (全网搜索 Flutter 资讯)
    • 收藏个人组件(保存到远端)
    • 反馈建议 (APP 在线 ISSUES
    • 分享链接 (APP分享)
  • go-cli 工具
    • Flutter Gopull request 工具
    • 命令行 生成 Flutter Go Widget 标准公共模版
    • markdown 模版动态化生成(合并到master分支后)
  • Flutter Go 官方 APP 版本自动升级

三方共建说明

由于 flutter 内容更新较快. 我们无法更快的丰富项目的内容. 如果您愿意为国内flutter的发展与学习贡献自己的力量, 请参考我们的 共建说明, 我们会将共建者的头像姓名贡献至我们的官网.

此处再次感谢所有已经提交 pr 的小伙伴

FlutterGo 期待你我共建~

具体 pr 细节和流程可参看 FlutterGo README 或 直接钉钉扫码入群

本文分享自微信公众号 - 全栈前端精选(isNealyang),作者:ryan730

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2019-09-01

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • 如何优雅简洁地实现时钟翻牌器(支持JS/Vue/React)

    双十一剁手节过去了,大家应该在很多网页中看到了数字翻牌的效果吧,比如倒计时、数字增长等。相信很多人都已经自己独立实现过了,我也在网上看了一些demo,发现HTM...

    Nealyang
  • 使用webpack实现react的热更新

    app 中自然就是源代码,app/index.js是最外层的js文件。因为涉及到是热更新,所以当然是在我们的 webpack.dev.js 文件下操作。

    Nealyang
  • 半小时带你入门 Flutter

    由于微信外链限制,推荐阅读等链接无法点击,可点击阅读原文跳转至原文,查看外链。??

    Nealyang
  • Flutter web 最新进展: 发掘更多可能!

    作者 / Mariam Hasnany, Product Manager, Flutter

    程序亦非猿
  • 【Flutter】362- 让前端开发者失业的技术,Flutter Web 初体验

    Flutter 是一种新型的 “客户端” 技术。它的最终目标是替代包含几乎所有平台的开发:iOS,Android,Web,桌面;做到了一次编写,多处运行。掌握 ...

    pingan8787
  • Java使用wsdl生成axis版本webservice服务端/客户端代码

    步骤摘要: 1、使用axis安装包的jar包 2、直接执行 WSDL2Java.main(new String[]{"-o", "src", "--serve...

    斯武丶风晴
  • Flutter SDK变更后的正确处理方式

    网上有些方法用了未必有效。比如有说直接修改项目中的.packages文件,改完后可能还会有问题。

    IT晴天
  • 百度要回归 A 股?

    作者 | 阿司匹林 3 月 3 日,第六次上“两会”的百度董事长李彦宏带来了四个提案,其中两个与百度的人工智能布局密切相关。除了带来提案以外,李彦宏在接受采访...

    AI科技大本营
  • Flutter填坑全面总结

    Flutter是一个新的跨平台开发的工具,博主也玩了一段时间,一步步的踩着坑摸石头过河,这其中受尽了各种各样的坑,各种谷歌,stackoverflow,Flut...

    AWeiLoveAndroid
  • Jenkins Jenkins结合GIT Maven持续集成环境配置

    下载地址:https://www.kernel.org/pub/software/scm/git/git-1.8.3.1.tar.gz

    授客

扫码关注云+社区

领取腾讯云代金券