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。