flutter webView 使用以及与 js 互操作

lzyprime 博客 (github)
创建时间：2020.03.06
qq及邮箱：2383518170

λ:

• 仓库地址：https://github.com/lzyprime/flutter_demos/tree/flutter_webview_demo

• git clone -b flutter_webview_demo https://github.com/lzyprime/flutter_demos.git
  

• 插件： webview_flutter ， 目前版本：^0.3.19+9

• 由于要兼顾 Android 和 Ios 两个平台的webView, js 调用native时无法直接返回数据，所以通过回调的形式曲线救国： 接到js请求后，处理数据，然后主动调用js相关函数。

• flutter 调用js 可以监听返回值

主要参数和方法

官方的example或者跳到源码一看便知

// 构造函数  
const WebView({
    Key key,
    this.onWebViewCreated, //webView创建完成后的回调函数， WebViewCreatedCallback(WebViewController controller)，会返回 webViewController
    this.initialUrl, //要加载的url地址
    this.javascriptMode = JavascriptMode.disabled, //js是否执行，默认值为不执行, JavascriptMode.unrestricted执行。不能为空
    this.javascriptChannels, // js 调用 flutter 时的处理者们，set。 所有JavascriptChannel的name不允许重复
    this.navigationDelegate, // 拦截请求并处理，详情请查看源码
    this.gestureRecognizers, // 手势监听与处理，详情请查看源码
    this.onPageStarted,  // 开始加载时的回调，PageStartedCallback(String url)
    this.onPageFinished, // 加载结束的回调，PageFinishedCallback(String url)
  
  /// 剩余参数英文直译即可，详情请查看源码
    this.debuggingEnabled = false,
    this.gestureNavigationEnabled = false,
    this.userAgent,
    this.initialMediaPlaybackPolicy =
        AutoMediaPlaybackPolicy.require_user_action_for_all_media_types,
  })  : assert(javascriptMode != null),
        assert(initialMediaPlaybackPolicy != null),
        super(key: key);

webViewController:

onWebViewCreated 会返回 当前webView的controller, 官方给的example里的做法是定义一个Completer 实现延迟初始化：

class _WebViewPageState extends State {
  final _controller = Completer();
  ....
  WebView(
        ....
        onWebViewCreated: (controller) {
            _controller.complete(controller);
        },
  )
  ....
}

之后对WebViewController 的调用通过 _controller.future 来实现，类型是Future, 所以全都是异步调用:

_controller.future.then((controller){
  ...
})
  // 或
 FutureBuilder(
  future: _controller.future,
  builder: (BuildContext context,AsyncSnapshot controller){
    return (Widget)
  }
)

主要函数：

// loadUrl，currentUrl，canGoBack ... 等函数
// 查看源码，看函数名和注释便知功能

///其中，js互操作常用：
Future evaluateJavascript("js 代码") // 执行js, 并且可以接收 js 执行的返回值

JavascriptChannel

  JavascriptChannel({
    @required this.name, // js 调用时的变量名，
    // 如name="Print", js可以通过 Print.postMessage(msg) 调用flutter
    // 请求会在 onMessageReceived 函数中处理
    
    @required this.onMessageReceived, // 处理js 请求
    // typedef void JavascriptMessageHandler(JavascriptMessage message);
    // message.message 即 js 调用时传递的msg
    // 函数没有返回值
    
  })  : assert(name != null),
        assert(onMessageReceived != null),
        assert(_validChannelNames.hasMatch(name));

封装互操作

Flutter 调用 js 是可以接收返回值的， js 写好函数，flutter 调就是了。
js 调用 flutter 无返回值， 所以要做一点简单封装

js 请求包与相应包格式：

// js 请求:
{
  guid: String, // 用于校验请求一致性，flutter 原封不动传回
  api: String, // 要请求的接口名, flutter 原封不动传回
  data: Object, 
  ...
  ...
}
  
// flutter 回包：
{
  guid: String, // 用于校验请求一致性，由js传入， flutter 原封不动传回
  api: String, // 要请求的接口名, 由js传入， flutter 原封不动传回
  data: Object, 
  ...
  ...
} 

flutter

// JavascriptChannel 以接口的形式实现，目的是将一组api封装在一起
// 当然也可以直接构造

class NativeBridge implements JavascriptChannel {
  BuildContext context; //来源于当前widget, 便于操作UI
  Future _controller; //当前webView 的 controller

  NativeBridge(this.context, this._controller);

  
  // api 与具体函数的映射表，可通过 _functions[key](data) 调用函数
  // 如 _functions["getValue"](null)
  get _functions => {
        "getValue": _getValue,
        "inputText": _inputText,
        "showSnackBar": _showSnackBar,
        "newWebView": _newWebView,
      }; 

  @override
  String get name => "nativeBridge"; // js 通过 nativeBridge.postMessage(msg); 调用flutter

  // 处理js请求
  @override
  get onMessageReceived => (msg) async {
            
            // 将收到的string数据转为json
        Map message = json.decode(msg.message);
    
            // 异步是因为有些api函数实现可能为异步，如inputText，等待UI相应
            // 根据 api 字段，调用具体函数
        final data = await _functions[message["api"]](message["data"]);
    
            // 组织回包
            final res = {
          "guid": message["guid"],
          "api": message["api"],
          "data": data
        }
    
            // 执行js函数，window.jsBridge.receiveMessage
            // 将数据转为字符串传递
        _controller.then((v) => v.evaluateJavascript(
            "window.jsBridge.receiveMessage(${json.encode(res)})"));
      };
  
  
  Map _getValue(data) => {"value": 1};

  Future> _inputText(data) async {
    String text = await showDialog(
        context: context,
        builder: (_) {
          final textController = TextEditingController();
          return AlertDialog(
            content: TextField(controller: textController),
            actions: [
              FlatButton(
                  onPressed: () => Navigator.pop(context, textController.text),
                  child: Icon(Icons.done)),
            ],
          );
        });
    return {"text": text ?? ""};
  }

  Map _showSnackBar(data) {
    Scaffold.of(context)
        .showSnackBar(SnackBar(content: Text(data["text"] ?? "")));
    return null;
  }

  Map _newWebView(data) {
    Navigator.of(context)
        .push(MaterialPageRoute(builder: (_) => WebViewPage(url: data["url"])));
    return null;
  }
}

加入webView中：

class _WebViewPageState extends State {
  final _controller = Completer();
    ...
  @override
  Widget build(BuildContext context) {
    ...
                WebView(
                        ...
          javascriptChannels: [NativeBridge(context, _controller.future)].toSet(),
          )
  }
}

js

我不会写js, 也省略了guid生成的部分。大概原理如下：

如果 Js 调用 flutter 需要返回值，则准备一个处理数据的回调函数，flutter 处理完数据后，主动调用回调函数。

为了方便flutter 调用，封装了 window.jsBridge.receiveMessage(msg), 该函数根据 guid和api字段分发到具体的回调函数。

～λ：

• 再次强调，我不会js，而且这只是简单的demo, 主要为了说明原理， 实际应用时肯定会更严格。但是方式还是类似：js 调用 flutter 并保存回调， flutter 处理完成后主动调用回调， 从而实现返回值

• 完整代码在仓库里，为了方便只有一个文件