Flutter 混合开发实战问题记录(四)编译运行时问题的一些总结(随时补充)

4,941 阅读6分钟

项目中的一些模块用flutter重新开发后在两次云测和灰度少量渠道后发现了些问题,分为两类:

一个是非编译/运行时问题,即dart语法使用错误或widget布局错误使用出现的问题

因为这类问题对于所有人几乎都会遇到,不再详细说解决方案,只简单罗列下我遇到的,提醒别人注意即可:

一、非编译/运行问题

1 黑黄相间提示:内容溢出

需要显示的内容超出了widget容器或屏幕的范围会出现,一般放入滚动容器中可解

2 image组件的封装

因为官方image组件提供了类似scaleType的属性:fit,当出现图片宽大于高,或高大于宽时,fitWidth或fitHeight就直接替换为BoxFit.cover吧,可以做下兼容,另外因为原生组件没有提供磁盘缓存功能,可以自己实现或直接加载个三方库,比较推荐 flutter_cached_network_image ,然后可以封装自己的imageloader了, 我写了个简易的例子

3 刘海屏适配:用 SafeArea 防止带刘海的屏幕,或者iPhonex 底部bottom 的页面显示异常

class FlutterAlign extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return SafeArea(
      child: Align(
        alignment: Alignment(-1, 1),
        child: Container(
          child: Text(
            "Hello",
          ),
        ),
      ),
    );
  }
}

4 关于toast

flutter作为一款UI框架,使用原则貌似是只要是实现不复杂,原生非不可替代的控件都应该用flutter来做,不过toast这个东西为了保持跟原生界面一致性,还是调用原生吧,不过我遇到的一个小问题是:有个界面有可能需要快速频繁提示toast,而且原生代码中使用的toast是自定义的不排队toast(继承Toast),由于内部机制,快速插入toast队列信息会造成系统等待,短时间不再响应toast弹出,解决方案可以是按钮控制节流(throttle)或防抖(debounce),也可以优化下toast排队机制。 不过最后还是决定用flutter做一个备用吧,网上的多数方案是使用Overlays

Overlays通过把子widget插入到overlay的stack里面, 让依赖它的子widget可以浮在其它的可见元素上面。OverlayEntry可以管理漂浮的widgets。(一个OverlayEntry就是一个层)

我贴一个简单实现

import 'package:flutter/material.dart';

class FlutterToast {
  static OverlayEntry _overlayEntry; //toast靠它加到屏幕上
  static bool _showing = false; //toast是否正在showing
  static DateTime _startedTime; //开启一个新toast的当前时间,用于对比是否已经展示了足够时间
  static String _msg;
  static void toast(
      BuildContext context,
      String msg,
      ) async {
    assert(msg != null);
    _msg = msg;
    _startedTime = DateTime.now();
    //获取OverlayState
    OverlayState overlayState = Overlay.of(context);
    _showing = true;
    if (_overlayEntry == null) {
      _overlayEntry = OverlayEntry(
          builder: (BuildContext context) => Positioned(
            //top值,可以改变这个值来改变toast在屏幕中的位置
            top: MediaQuery.of(context).size.height * 2 / 3,
            child: Container(
                alignment: Alignment.center,
                width: MediaQuery.of(context).size.width,
                child: Padding(
                  padding: EdgeInsets.symmetric(horizontal: 80.0),
                  child: AnimatedOpacity(
                    opacity: _showing ? 1.0 : 0.0, //目标透明度
                    duration: _showing
                        ? Duration(milliseconds: 100)
                        : Duration(milliseconds: 400),
                    child: _buildToastWidget(),
                  ),
                )),
          ));
      overlayState.insert(_overlayEntry);
    } else {
      _overlayEntry.markNeedsBuild();
    }
    await Future.delayed(Duration(milliseconds: 2000)); //等待两秒

    if (DateTime.now().difference(_startedTime).inMilliseconds >= 2000) {
      _showing = false;
      _overlayEntry.markNeedsBuild();
    }
  }

  static _buildToastWidget() {
    return Center(
      child: Card(
        color: Colors.black,
        child: Padding(
          padding: EdgeInsets.symmetric(horizontal: 10.0, vertical: 8.0),
          child: Text(
            _msg,
            style: TextStyle(
              fontSize: 14.0,
              color: Colors.white,
            ),
          ),
        ),
      ),
    );
  }
}

可以根据需要调节UI,让它和你的原生toast保持一致,但是有个问题,它弹出后会被键盘覆盖,由于机制问题,所以暂时貌似还不能解决,也因如此,flutter这种toast默认在中间弹出防止被盖住。

5 错误:Another exception was thrown: Invalid argument(s)

发生场景:

String name;
 Container(
 padding: EdgeInsets.only(top: 5.0),
 child: Text(
   "名字:" + name ?? "",
   style: TextStyle(fontSize: 14.0, color: const Color(0xFF878E9F)),
 ),
),

对非空判断符号使用的错误

name ?? "" , 独立使用没有问题,不过拼接到字符串中需要改成这样:

"名字:" + (name ?? "")

6 dio库的异常捕获

强大的网络请求Dio库在请求过程中发生错误,入无网络或者非200的错误码响应等异常只会在控制台中打印出以下类似信息

Unhandled Exception: DioError [DioErrorType.DEFAULT]: SocketException: Failed host lookup:

假如你用

try{
   dio.post()... 
}on DioError catch (e) {
   print(e.message); 
}

无法捕获到请求内部异常,查看源码可知 dio.post的返回值是Future, 并且它也使用的是catchError((err) => throw_assureDioError(err)); 来捕获异常。

所以我们使用的时候也要使用Future的api来捕获

dio.post()
    .then((resp) => {
        ...  
    }).catchError((e){
           print(e.message);
        });





--------------------------------------分割线---------------------------------------





另外一类问题就是直接debug或release报错,或者机型适配出现的问题了,多出现在dart VM或SDK中

二、编译运行问题

1 [FATAL:flutter/runtime/dart_vm.cc(416)] Error while initializing the Dart VM: Wrong full snapshot version, expected '0c73eb70aa4d30f450273cb424be8c62' found 'eed485c757fba5d731e4054412c99f2e'

问题发生于升级flutter sdk之后,看上边的日志Wrong full snapshot version可以猜测:升级了sdk,但是之前已生成的编译产物还是旧的,不匹配,需要重新build一下,搜索了issue后找到了个方案:

1) removing the content of flutter/bin/cache

2) then running flutter upgrade again

3) then running flutter clean prior to flutter run

2 部分红米手机的崩溃

E/flutter: [ERROR:flutter/runtime/dart_vm.cc(259)] VM snapshot must be valid. A/flutter: [FATAL:flutter/shell/common/shell.cc(212)] Check failed: vm. Must be able to initialize the VM. --------- beginning of crash

升级sdk到1.4之后解决

3 cpu架构中so包支持问题

因为是混合开发,flutter作为插件支持原生项目,所以需要支持什么样的cpu架构视原生项目情况而定,我们的平台底层库只支持

ndk {
    abiFilters 'armeabi'
    }

对于flutter SDK的修改:我们只需要修改android-arm、android-arm-profile和android-arm-release下的flutter.jar,将其中的lib/armeabi-v7a/libflutter.so移动到lib/armeabi/libflutter.so即可:

1 先进入目录
cd $FLUTTER_ROOT/bin/cache/artifacts/engine

2 然后执行 
for arch in android-arm android-arm-profile android-arm-release; do
  pushd $arch
  cp flutter.jar flutter-armeabi-v7a.jar # 备份
  unzip flutter.jar lib/armeabi-v7a/libflutter.so
  mv lib/armeabi-v7a lib/armeabi
  zip -d flutter.jar lib/armeabi-v7a/libflutter.so
  zip flutter.jar lib/armeabi/libflutter.so
  popd
done

注: 所有的x86/x86_64/armeabi-v7a/arm64-v8a设备都支持armeabi架构的.so文件,因此似乎移除其他ABIs的.so文件是一个减少APK大小的好技巧。但事实上并不是:这不只影响到函数库的性能和兼容性,x86设备能够很好的运行ARM类型函数库,但并不保证100%不发生crash,特别是对旧设备。64位设备(arm64-v8a, x86_64, mips64)能够运行32位的函数库,但是以32位模式运行,在64位平台上运行32位版本的ART和Android组件,将丢失专为64位优化过的性能(ART,webview,media等等)。

4 错误:Reply already submitted

java.lang.IllegalStateException: Reply already submitted at io.flutter.view.FlutterNativeView$PlatformMessageHandlerImpl1.reply(FlutterNativeView.java:197)at io.flutter.plugin.common.MethodChannelIncomingMethodCallHandler$1.success(MethodChannel.java:204)

发生场景: Flutter 通过 eventMethod 调用原生端方法,该方法是在switch case 语句段中,因为没有写break,大概导致了 MethodChannel.Result 返回给Flutter参数时调用了多次,直接把switch case 中的break补充上就没有再复现,不过GitHub中的issue场景貌似要复杂一些,可以参考github