HarmonyOS开发:封装一个便捷的Log工具类

前言

日志打印,没什么好说的,系统已给我们提供,且调用也是非常的简单,我们封装的目的,一是扩展 ,打印一些不常见的类型,比如格式化json,使得日志看起来比较好看,二是,控制日志的开关 ,使其动态开启打印和关闭打印,三是,简化代码,使其调用起来更加的方便。

如下图所示,便是我们封装之后的打印效果。

本章的内容大致如下,关于源码解析,我们放到下篇文章概述。

1、Log工具快速使用

2、全局初始化

3、基本打印

4、开源地址

一、Log工具快速使用

目前Log工具类已经开源,在源码中的README中已经做了很详细的介绍,当然了,你也可以按照如下的方式进行快速使用。

私服和远程依赖 ,由于权限和审核问题,预计需要等到2024年第一季度面向所有开发者,所以,暂时只能使用本地静态共享包源码两种使用方式,本地静态共享包类似Android中的aar依赖,直接复制到项目中即可。

1、本地静态共享包har包使用

首先,下载har包,点击下载

下载之后,把har包复制项目中,目录自己创建,如下,我创建了一个libs目录,复制进去。

引入之后,进行同步项目,点击Sync Now即可,当然了你也可以,将鼠标放置在报错处会出现提示,在提示框中点击Run 'ohpm install'。

需要注意,@app/log,是用来区分目录的,可以自己定义,比如@aa/bb等,关于静态共享包的创建和使用,请查看如下我的介绍,这里就不过多介绍。

HarmonyOS开发:走进静态共享包的依赖与使用

2、源码直接使用

下载源码后,直接把源码中log这个module复制到项目中,直接引用即可:

引入之后,进行同步项目,点击Sync Now即可,当然了你也可以,将鼠标放置在报错处会出现提示,在提示框中点击Run 'ohpm install'。

如果您的DevEco Studio低于4.0,您需要更改log模块里的hvigorfile.ts文件

修改前

TypeScript 复制代码
import { harTasks } from '@ohos/hvigor-ohos-plugin';

export default {
  system: harTasks,  /* Built-in plugin of Hvigor. It cannot be modified. */
  plugins:[]         /* Custom plugin to extend the functionality of Hvigor. */
}

修改后

TypeScript 复制代码
export { harTasks } from '@ohos/hvigor-ohos-plugin';

并需要进行模块的引入,在跟项目中build-profile.json5文件里添加如下:

json 复制代码
{
  "app": {
    "signingConfigs": [],
    "compileSdkVersion": 9,
    "compatibleSdkVersion": 9,
    "products": [
      {
        "name": "default",
        "signingConfig": "default"
      }
    ]
  },
  "modules": [
    {
      "name": "entry",
      "srcPath": "./entry",
      "targets": [
        {
          "name": "default",
          "applyToProducts": [
            "default"
          ]
        }
      ]
    },
    {
      "name": "log",
      "srcPath": "./log"
    }
  ]
}

3、查看是否引用成功

无论使用哪种方式进行依赖,最终都会在使用的模块中,生成一个oh_modules文件,并创建源代码文件,有则成功,无则失败,如下:

二、全局初始化

初始化仅需要初始化一次即可,可以在AbilityStage进行,目前初始化中均有默认值,如果您使用默认值,就无需进行初始化。初始化采用的是对象参数传递形式,其参数您可以按实际需要进行传递,如果想和默认值保持一致,有些参数就可以省略。

TypeScript 复制代码
Log.init({
  tag: "HarmonyOSLog",
  domain: 0x0000,
  close: false,
  isHilog: true,
  showLogLocation: true,
  logSize: 800
})

初始化参数介绍

属性 类型 概述
tag string 打印的标签,默认为: HarmonyOSLog
domain number 输出日志所对应的业务领域,默认为0x0000
close boolean 是否关闭打印,默认true为打开,false为不打印
isHilog boolean 打印类型,默认为true是hilog打印 ,false为console
mShowLogLocation boolean 是否展示点击的位置,默认为true是展示 ,false为不展示
logSize number 日志每次输出大小,最大1024字节

二、基本打印

统一标签打印

使用统一标签进行打印,直接传递打印内容即可。

TypeScript 复制代码
Log.info("我是一个info类型日志")
Log.debug("我是一个debug类型日志")
Log.warn("我是一个warn类型日志")
Log.error("我是一个error类型日志")
Log.fatal("我是一个fatal类型日志")

自定义标签

使用自定义标签进行打印

TypeScript 复制代码
Log.info("我是一个info类型日志", "testTag")
Log.debug("我是一个debug类型日志", "testTag")
Log.warn("我是一个warn类型日志", "testTag")
Log.error("我是一个error类型日志", "testTag")
Log.fatal("我是一个fatal类型日志", "testTag")

json打印

json打印会进行格式化处理,直接传递json对象或者json字符串即可。

TypeScript 复制代码
Log.info({ "name": "AbnerMing", "age": 18 })

四、开源地址

gitee.com/abnercode/h...

开发环境

DevEco Studio 4.0 Beta2,Build Version: 4.0.0.400

Api版本:9

hvigorVersion:3.0.2

常见问题

如果你的开发环境比较低,会造成,下载源码,运行工程失败问题,常见错误如下,是因为开发环境不一致造成。

您可以选择解决问题,解决方式如下:

解决DevEco Studio低版本导入高版本项目运行失败问题

您也可以不运行,直接按照文档进行使用,完全没有问题。

相关推荐
爱笑的眼睛1120 分钟前
HarmonyOS 应用开发深度解析:基于 ArkTS 的现代化状态管理实践
华为·harmonyos
潜龙952720 分钟前
第6.2节 Android Agent开发<二>
android·python·覆盖率数据
娅娅梨1 小时前
HarmonyOS-ArkUI Web控件基础铺垫7-HTTP SSL认证图解 及 Charles抓包原理 及您为什么配置对了也抓不到数据
http·华为·ssl·harmonyos
安卓开发者1 小时前
鸿蒙NEXT的Web组件网络安全与隐私保护实践
前端·web安全·harmonyos
网安Ruler1 小时前
代码审计-PHP专题&原生开发&SQL注入&1day分析构造&正则搜索&语句执行监控&功能定位
android
搜狐技术产品小编20232 小时前
CAEmitterLayer:iOS 中创建炫酷粒子效果的魔法工具
macos·ios·objective-c·cocoa
paid槮3 小时前
MySql基础:数据类型
android·mysql·adb
用户2018792831674 小时前
AMS和app通信的小秘密
android
用户2018792831674 小时前
ThreadPoolExecutor之市场雇工的故事
android
诺诺Okami4 小时前
Android Framework-Launcher-InvariantDeviceProfile
android