HarmonyOS 鸿蒙Next 浅尝三方库eftool之安装和使用

HarmonyOS 鸿蒙Next 浅尝三方库eftool之安装和使用 大家好，本人是oh三方库eftool的作者，从今天开始，带大家从简单开始一点点剖析和使用eftool工具类,将会做成章节系列，欢迎大家踊跃提出意见和需求

三方库地址

• https://ohpm.openharmony.cn/#/cn/home
• https://gitee.com/yunkss/tpc_resource

如上两个官网地址均可查找自己所需的三分库

版本说明【重要】

• 1.0.x 版本系列兼容API9
• 1.1.x 版本系列兼容API11

使用API9版本

• 查找适合自己的版本号

  

• 在项目目录下打开 Terminal 窗口执行如下命令

ohpm install [@yunkss](/user/yunkss)/eftool@1.0.x
x替换为自己想要的版本号

此处需注意,如果需要使用API9版本
但是直接执行了 ohpm install [@yunkss](/user/yunkss)/eftool
默认下载的是最新版，如图为1.1.9而1.1.9版本是兼容API11,故会在API9版本中报错

• 命令运行成功后，在项目的 oh-package.json5 文件中会自动添加上依赖,如图所示

  

• 在页面中使用 import 引入三方库

import { CacheUtil, OutDTO, Logger, IdCardUtil, ToastUtil, ActionUtil, DialogUtil } from '[@yunkss](/user/yunkss)/eftool'

使用API11版本

• 查找适合自己的版本号

  

• 在项目目录下打开 Terminal 窗口执行如下命令

ohpm install [@yunkss](/user/yunkss)/eftool@1.1.x
x替换为自己想要的版本号

• 命令运行成功后，在项目的 oh-package.json5 文件中会自动添加上依赖,如图所示

  

• 在页面中使用 import 引入三方库

import {
  SM2,
  JSONObject,
  JSONArray,
  LoadingUtil,
  TipsUtil,
  ConfirmUtil,
  Cascade,
  DateConst,
  AuthUtil,
  WindowUtil,
  NotificationUtil,
  LocationUtil,
  efAxios,
  efAxiosParams,
  efClientApi
} from '[@yunkss](/user/yunkss)/eftool'

• 更多组件使用方法详见文档 eftool使用文档

eftool目前提供以下五部分组件：

• 基础类组件

  • 目前主要包含IdCardUtil，IdUtil，IdUtil，RegUtil，StrUtil，PageUtil，OutDTO，PhoneUtil，OutDTO，PageQuery，Logger，RegexConst等功能，提供各种对于身份证号是否合法校验，JSON对象字符串集合相互转换，字符串以及集合的非空，替换等快捷方法，提供统一的返回传输返回对象，接口分页类和纯前端分页对象等。

• 加密类组件

  • 目前主要包含AES,RSA,3DES,SM2,SM3,SM4等常见加解密,以及提供服务器端与鸿蒙端密钥转换等功能，提供方便快捷的加解密，签名验签，动态协商等功能。

• 网络相关类组件

  • 目前主要包含二次封装的efAxios,efClientApi等，提供统一请求响应拦截处理，并提供统一的上传下载功能，而且提供使用SM2,SM3,SM4混合整体传输加密，以及关键字加密并且附带完整JAVA后端项目，提高开发的安全性。

• JSON类组件

  • 目前主要包含JSONObject,JSONArray等，提供字符串与json对象和json数组的相互转换，以及实体对象与JSON的相互转换等。

• UI类组件

  • 目前主要包含ToastUtil，DialogUtil，ActionUtil，Cascade,WinDialogUtil.PreviewUtil,LocationUtil等，提供方便快捷的弹框提示，省市级联组件，警告提示，通知，弹出菜单,定位，授权,全局自定义弹窗，文件预览，拉起picker等组件。

至此，我们可以愉快的使用eftool了