目录
- Guide
- Logger源码分析
- 知识点
- 移植到鸿蒙
- 思考
Guide
本文基于https://gitee.com/openharmony-tpc/logger 分析Logger的源码，及移植到鸿蒙需要做的工作。
在安卓to鸿蒙系列：Timber 里我就已经提到，我喜欢Logger和Timber一起使用。原因很简单，因为Timber接口简洁，Logger的输出样式好看。
常规套路：
- FormatStrategy formatStrategy = PrettyFormatStrategy.newBuilder()
- .tag("DwGG") // (Optional) Global tag for every log. Default PRETTY_LOGGER
- .build();
- Logger.addLogAdapter(new AndroidLogAdapter(formatStrategy));
- Timber.plant(new Timber.DebugTree() {
- @Override
- protected void log(int priority, String tag, String message, Throwable t) {
- Logger.log(priority, tag, message, t);
- }
- });
Logger源码分析
Timber只有一个文件，600多行代码，Logger相对复杂一些，不过结构也一样简单，很容易读懂源码。和Timber一样，Logger的扩展性也一样优秀。
Timber内置了DebugTree(在控制台输出日志)。Logger内置了AndroidLogAdapter(控制台输出)、DiskLogAdapter(输出日志到本地磁盘)
先看图，有一个整体的认识：
解释一下上面的图：
1.Logger 也使用了 委托(delegate)模式，Logger把所以的操作都委托给了Printer printer
2.Printer 是日志能力的抽像(即，定义了日志工具的api)，类似于Timber中的Tree。定义的api有：
- 日志相关api：v()、d()、i()、e()、wtf()，以及xml()、json()对xml、json数据格式的支持。
- 设置临时tag：t()
- LogAdapter相关api：addAdapter(LogAdapter adapter)、clearLogAdapters()
Printer的默认实现是LoggerPrinter，我们可以自定义自己的实现。不过，多数情况下貌似没必要。
3.与Timber相比，Logger对Timber中的Tree进一步抽像。以 LogAdapter 适配不同的日志能力，如Android控制台输出(AndroidLogAdapter)、保存到磁盘(DiskLogAdapter)。
从类名上，我们也能看出用了适配器(apapter)模式
当然我们也可以定义鸿蒙HiLog控制台输出的LogAdapter(取个名字：HarmonyLogAdapter)
4.FormatStrategy 格式化原始数据，决定了LogAdapter输出日志的样式。
AndroidLogAdapter中的默认实现是PrettyFormatStrategy(可以显示线程信息、统一的tag:"PRETTY_LOGGER"、线程栈);
DiskLogAdapter中的默认实现是CsvFormatStrategy(csv文件的格式);
5.LogStrategy 最终决定FormatStrategy输出日志的目标(如：控制台LogcatLogStrategy、磁盘DiskLogStrategy)
更详细的分析请移步：Android日志系统第三方库------Logger 源码分析
知识点
1.临时tag的实现方法
很简单，Logger.t("临时tag").d(xxx);设置临时tag。使用一次就删除。最终也是委托给Printer来实现。
为了性能，LoggerPrinter和Timber一样，也使用ThreadLocal以空间换时间。
2.多线程支持方面，只有LoggerPrinter的synchronized void log()加了锁。
个人认为，应该把LoggerPrinter的addAdapter(LogAdapter adapter)和 clearLogAdapters()都加上锁。
因为log()方法加锁，所以一定要保证此方法的执行效率。 不然，如果一个线程写日志太耗时，会影响其它线程的执行。
3.接上一条，DiskLogStrategy 在写文件时，在独立的HandlerThread线程中执行，可以保证LoggerPrinter的void log()方法的执行时间。
移植到鸿蒙
通过上面的分析，我们可以知道，移植到鸿蒙需要的工作有：
1.实现HarmonyLogAdapter提供 控制台输出 的能力，其中PrettyFormatStrategy基本可以复用，只要修改LogcatLogStrategy的实现，用HiLog替换android.util.Log相关的操作。
- public PrettyFormatStrategy build() {
- if (logStrategy == null) {
- logStrategy = new LogcatLogStrategy();
- }
- return new PrettyFormatStrategy(this);
- }
2.修改DiskLogAdapter提供 输出日志到文件 的能力。其中CsvFormatStrategy基本可以复用，只要修改日志文件路径的设置以及Handler相关的类。
- String diskPath = Environment.getExternalStorageDirectory().getAbsolutePath();
- String folder = diskPath + File.separatorChar + "logger";
- HandlerThread ht = new HandlerThread("AndroidFileLogger." + folder);
- ht.start();
- Handler handler = new DiskLogStrategy.WriteHandler(ht.getLooper(), folder, MAX_BYTES);
修改为：
- String folder = "/storage/emulated/0/" + File.separatorChar + "logger";
- String newThreadName = "FileLogger" + folder;
- EventRunner ht = EventRunner.create(newThreadName);
- EventHandler handler = new DiskLogStrategy.WriteHandler(ht, folder, MAX_BYTES);
同理DiskLogStrategy里的Handler也要改为EventHandler。
思考
上图是最终的效果。从代码中可以看到HiLogLabel是固定的，所以domain和tag都是固定的。而为了实现自定义tag的目的，把自定义tag输出到了message里，所以我们可以看到两个"PRETTY_LOGGER"，视觉上不太完美。
- public class LogcatLogStrategy implements LogStrategy {
- static final String DEFAULT_TAG = "NO_TAG";
- static final String TAG_LOG = "[PRETTY_LOGGER] ";
- static final int DOMAIN_ID = 0xD000F00;
- static final HiLogLabel LABEL_LOG = new HiLogLabel(3, DOMAIN_ID, TAG_LOG);
- }
优化的方法可以参考 Timber_ohos的实现。
