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低版本导入高版本项目运行失败问题

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

相关推荐
CocoaKier1 小时前
苹果开发者注意,请在2027年1月31日前完成合规验证,否则中国区可能下架
ios·aigc·apple
码间留白5 小时前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
二流小码农5 小时前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
bcbnb5 小时前
Windows 上 iOS 开发接 CI,KXBuild 自托管 runner 出签名 ipa
后端·ios
阿杰m7 小时前
Android源码第十七章:PowerManager 与后台任务——锁屏后怎么跑?
android
JMchen1237 小时前
【Android 性能优化实战 60 讲】10 Jetpack App Startup 内核魔改:手写异步懒加载启动框架,根治串行初始化耗时
android·性能优化·源码分析·启动优化·kotlin协程·app startup
2601_967980118 小时前
python+appium自动化测试如何控制App的启动和退出
android·自动化测试·python·appium·设备调试
booboosui9 小时前
不写安装器:点一下就往对话里塞 152 个字符
android
威哥爱编程9 小时前
模拟面试智能体开发实战 12:每篇都能跑不等于接起来能跑,端到端联调收官把十一块拼图合成一个能用的智能体
python·agent·harmonyos
威哥爱编程9 小时前
模拟面试智能体开发实战 11:报告只躺在后端怎么复盘,把总评搬上手机还要适配大小屏
python·agent·harmonyos