【HarmonyOS】公司鸿蒙项目收工总结之《三方库》

作者：zhongcx

2024-10-11
广东
本文字数：1929 字
阅读完需：约 6 分钟

并分享项目中使用到的库

一、使用三方库时注意事项

1. 版本兼容问题

在使用 ohpm install 库名命令安装三方库时，可能会遇到版本不匹配的问题。尽管代码在 IDE 中没有提示错误，但在运行时可能会抛出异常。此时需要前往 OpenHarmony 三方库中心仓库查看最新的版本号，并尝试更换不同的版本。

2. 自动化测试配置问题

在配置自动化测试时，可能会遇到因版本号使用 ^ 导致的问题。例如，在 oh-package.json5 文件中，应该将 @xxx": "^1.0.0" 更改为 @xxx": "1.0.0"，以确保版本号精确指定。

3. ohpm 命令识别问题

如果在使用 ohpm install 命令时遇到 “The term 'ohpm' is not recognized as the name of a cmdlet” 错误，说明 DevEco Studio 的环境变量配置不正确或版本过旧。建议卸载旧版本并重新安装最新版 DevEco Studio。

4. 跨平台库移植问题

Android 或 iOS 中使用的.so 库无法直接移植到 HarmonyOS 项目中使用。需要采用 HarmonyOS 支持的方式来编写 C++代码，并重新编译生成.so 库。

二、主要使用的三方库

1、数据解析方案

接口返回的数据通常需要转换为类（class）的形式来方便使用。这样不仅提高了代码的可读性和可维护性，还可以利用类的方法来进行数据处理。

推荐库：

• class-transformer

• @yunkss/ef_json

• @pura/harmony-utils

其中，class-transformer 和 @pura/harmony-utils 在解析数据时，可以保留类中的方法。在我们的项目中选择了 class-transformer。

代码示例：

import { plainToClass } from 'class-transformer'import { JSONObject } from '@yunkss/ef_json'import { JSONUtil } from '@pura/harmony-utils';
class Ohter {  dateofBirth: string = ""}
class User {  name: string = ""  ohter?: Ohter
  getAge() {    if (!this.ohter) {      return '数据异常'    }    const today = new Date();    const birthDate = new Date(this.ohter.dateofBirth);    let age = today.getFullYear() - birthDate.getFullYear();    return age;  }}

@Entry@Componentstruct Index {  userJson: string = `{ "name":"张三","ohter":{"dateofBirth":"2000-01-01"}}`  userJson_2: string = `{ "name":"李四" }`
  build() {    Column() {      Text('ohpm i @pura/harmony-utils')      Button('harmony-utils 解析时，方法会丢失').onClick(() => {        let mUser: User|null = JSONUtil.jsonToBean(User, this.userJson);        console.info(`姓名:${mUser?.name}`)        try {          console.info(`年龄:${mUser?.getAge()}`)        } catch (e) {          console.error(`年龄出错`, e)        }      })      Text('ohpm install @yunkss/ef_json')      Button('@yunkss/ef_json 解析时，方法会丢失').onClick(() => {        let mUser: User = JSONObject.parseObject<User>(this.userJson);        console.info(`姓名:${mUser.name}`)        try {          console.info(`年龄:${mUser.getAge()}`)        } catch (e) {          console.error(`年龄出错`, e)        }      })
      Text('ohpm install class-transformer')      Button('class-transformer 在解析数据时，方法不会丢失').onClick(() => {        let mUser: User = plainToClass(User, JSON.parse(this.userJson))        console.info(`姓名:${mUser.name}`)        console.info(`年龄:${mUser.getAge()}`)      })
    }    .width('100%')    .height('100%')  }}

复制代码

输出：

姓名:张三年龄:24姓名:张三年龄出错 TypeError: is not callable姓名:张三年龄:24

复制代码

2、网络请求方案

网络请求是移动应用中常见的功能之一，HarmonyOS 提供了多种库供选择。

推荐库：• @ohos/axios• @yunkss/ef_axios• import { http } from '@kit.NetworkKit';（官方）

由于团队习惯使用 Axios，因此选择了 @ohos/axios。

3、加密方案

加密是保护数据安全的重要手段，HarmonyOS 提供了多种库供选择。

推荐库：• import { cryptoFramework } from '@kit.CryptoArchitectureKit';（官方）• ohpm install @yunkss/ef_crypto• class-transformer

在项目中广泛使用了 class-transformer，因为它除了数据解析外还有其他实用功能。

4、设备唯一标识

获取设备的唯一标识符是许多应用的基本需求之一。

推荐库：• class-transformer• @ranran/utilcode

使用三方库获取设备唯一标识符的一个优点是，即使卸载重装，该标识符依然保持不变。

5、支付宝 SDK

对于支付功能，我们选择了 @cashier_alipay/cashiersdk。

注意事项：测试时需使用真机，因为模拟器和预览器可能不支持。

6、Tab 样式

为了实现美观的 Tab 布局，我们使用了 @zyc/tablayout。

发布于: 刚刚阅读数: 4

zhongcx

关注

还未添加个人签名 2024-09-27 加入

还未添加个人简介

发布

暂无评论

创作场景

【HarmonyOS】公司鸿蒙项目收工总结之《三方库》

zhongcx

评论