阅读 3307

Flutter实战之自定义日志打印组件

前言

在Flutter中,如果我们需要打印日志,如果不进行自定义,我们只能使用自带的print()或者debugPrint()方法进行打印,但是这两种打印,日志都是默认Info层级的日志,很不友好,所以如果需要日志打印层级分明,我们就需要自定义一个日志打印组件,以下就来介绍如何自定义日志打印组件。

如何让输出的日志层级分明?

换种方式想,如果我们能在Flutter代码中,能够调用到原始Android中的Log组件,岂不是就能解决日志打印问题?

如何进行关联

在Flutter中,可以使用MethodChannel进行关联,让Flutter调用特定平台(如Android、IOS)的相关API,对于MethodChannel的使用说明和相关介绍,可参考官方文档: 点击查看

这里简单说明下, Flutter关于特定平台的API,主要是依赖其灵活的消息传递方式来执行的,而并非一套完整的代码生成的。啥意思呢?

  • Flutter可以通过平台通道向其宿主(Android、IOS)发送消息;
  • 其宿主监听平台通道,接收发送过来的消息;
  • 宿主平台通过接收到的消息执行宿主特有的API,然后将响应结果返回给客户端(也就是Flutter部分)更新状态。

下面用代码简单说明:

  • Step1:创建Flutter平台客户端
import 'package:flutter/services.dart';

///一个日志打印工具类
class LogUtils {
  LogUtils._();

  //第一步:设置平台,并进行命名
  static const _platform = const MethodChannel('com.yancy.flutter.plugins/log');

  //第二步,设置相关需要传递的方法
  //invokeMethod方法接收的参数,第一个必选参数,设置的是方法的名称;后面的参数为可选的需要传递的参数
  static void i(String tag, String msg) {
    _platform.invokeMethod('logI', {'tag': tag, 'msg': msg});
  }

  static void d(String tag, String msg) {
    _platform.invokeMethod('logD', {'tag': tag, 'msg': msg});
  }

  static void v(String tag, String msg) {
    _platform.invokeMethod('logV', {'tag': tag, 'msg': msg});
  }

  static void w(String tag, String msg) {
    _platform.invokeMethod('logW', {'tag': tag, 'msg': msg});
  }

  static void e(String tag, String msg) {
    _platform.invokeMethod('logE', {'tag': tag, 'msg': msg});
  }

}
复制代码
  • Step2:宿主端建立对应通道接收端
package com.yancy.flutter.host;

import android.content.Context;
import android.util.Log;
import android.widget.Toast;

import io.flutter.plugin.common.BinaryMessenger;
import io.flutter.plugin.common.MethodChannel;

/**
 * 说明:
 *
 * @author Yancy
 * @date 2019/3/15
 */
public class CustomFlutterPlugins {
  
    //这里必选要跟Flutter平台名称对应上,否则无法接收消息
    private static final String LOG_CHANNEL_NAME = "com.yancy.flutter.plugins/log";

    public static void registerLogger(BinaryMessenger messenger) {
        new MethodChannel(messenger, LOG_CHANNEL_NAME).setMethodCallHandler((methodCall, result) -> {
            String tag = methodCall.argument("tag");
            String msg = methodCall.argument("msg");
            switch (methodCall.method) {
                case "logV":
                    Log.v(tag, msg);
                    break;
                case "logD":
                    Log.d(tag, msg);
                    break;
                case "logI":
                    Log.i(tag, msg);
                    break;
                case "logW":
                    Log.w(tag, msg);
                    break;
                case "logE":
                    Log.e(tag, msg);
                    break;
                default:
                    Log.d(tag, msg);
                    break;
            }
        });
    }
}
复制代码

上面的switch里面的部分即对于flutter中invokeMethod方法中的第一个参数名称。

  • Step3:然后我们在宿主的MainActivity中进行调用注册即可完成通道的建立。
public class MainActivity extends FlutterActivity {
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    GeneratedPluginRegistrant.registerWith(this);

    CustomFlutterPlugins.registerLogger(getFlutterView());
  }
}
复制代码
  • Step4:Flutter中调用LogUtils相关方法,打印日志。
class MyApp extends StatelessWidget {

  @override
  Widget build(BuildContext context) {
    print('print------');
    debugPrint('debugPrint-----');
    LogUtils.v('yancy', 'v-------');
    LogUtils.d('yancy', 'd-------');
    LogUtils.i('yancy', 'i-------');
    LogUtils.w('yancy', 'w-------');
    LogUtils.e('yancy', 'e-------');

    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),

      home: MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}
复制代码

控制台输出的打印结果如下:

至此,一个简单的日志打印组建就开发完成啦。

结语

目前Flutter很多组建需要原始平台API支持,我们完全可以利用好MethodChannel进行相关功能开发,例如Flutter中对于toast提示,目前自带的是SnackBar组件,如果想要使用Android自带的Toast,完全可以使用本文中类似的方法进行封装。

Tips

关于Flutter日志打印,评论区说到devtools关于日志的打印,大家也可以看看这里的说明devtools/logging

关注下面的标签,发现更多相似文章
评论