HarmonyOS 鸿蒙应用开发(九、还是蓝海,如何贡献第三方库)

快来共享第三方库吧,不但可以通过分享自己的成果,可以获得来自全球开发者的技术反馈和建议,提升自身技术能力,还有助于提高个人或团队在开源社区中的知名度和影响力。在流量时代和粉丝经济时代,获得曝光度和流量密码。

HarmonyOS 系统是当下热门的风,也是未来潜力巨大的万物互联的操作系统和技术底座。无意间浏览了下鸿蒙的开源第三方共享库,发现库好少啊,还是一片蓝海。那么你贡献的三方库可能会被很多人看到和使用,一方面促使你不断学习和进步,一方面获得流量和提升知名度。

概述

OHPM(OpenHarmony Package Manager)由OpenHarmony三方库中心仓网站、命令行工具、OpenHarmony三方库中心仓仓库三个部分组成,其功能如下:

  • OpenHarmony三方库中心仓网站(website):用于检索、查看所需 OpenHarmony 三方库信息,也可管理关于 ohpm 的个人配置
  • 命令行工具(cli):OpenHarmony 三方库的包管理工具
  • OpenHarmony三方库中心仓仓库(registry):存储三方库软件及其元数据的仓库

官方三方库地址 

地址:OpenHarmony三方库中心仓

HarmonyOS 鸿蒙应用开发(九、还是蓝海,如何贡献第三方库)_第1张图片

鸿蒙生态三方库,是在鸿蒙系统上可重复使用的软件库,可帮助开发者重用技术资产快速开发鸿蒙生态应用、元服务,提升开发效率。根据不同的开发语言分为两种:

ArkTS/TS/JS 语言的三方库,可直接导入并使用。

C/C++语言的三方库,在应用开发中通过 NAPI的方式来使用。

鸿蒙生态三方库发布与使用完整的流程如下图所示:

HarmonyOS 鸿蒙应用开发(九、还是蓝海,如何贡献第三方库)_第2张图片

鸿蒙生态中心仓聚合了丰富的鸿蒙生态开发三方库,方便开发者一站式获取。个人/组织贡献者将开发好的三方库通过 OHPM 发布到中心仓。

开发者通过如下方式即可方便快捷的使用三方库:

1.应用开发者登录鸿蒙生态中心仓,通过分类和关键字搜索需要的三方库信息。

2.应用开发者在应用开发时,通过 OHPM 包管理工具,将搜索到的三方库导入应用。

如何在项目中引入三方库

引用 OpenHarmony 三方库中心仓中的三方库

在 oh-package.json5 文件中声明三方库,以 @ohos/crypto-js 为例:

"dependencies": {
   "@ohos/crypto-js": "2.0.1"
}

依赖声明之后,执行以下命令,依赖三方库会存储在当前目录的 oh_modules 目录下。

 ohpm install

安装指定名称 pacakge_name 的三方库,执行以下命令,将自动在当前目录下的 oh-package.json5 文件中自动添加三方库依赖。

ohpm install 

引用本地文件夹

在 oh-package.json5 文件中配置三方库文件信息:

"dependencies": {
   "foler": "file:../folder"
}

执行以下命令进行安装,依赖三方库会存储在当前目录的 oh_modules 目录下。

ohpm install

执行以下命令进行安装,将在 oh-package.json5 文件中自动添加依赖。

ohpm install ../folder

引用本地压缩包

在 oh-package.json5 文件中配置三方库文件信息:

"dependencies": {
   "package": "file:./package.har"
}

执行以下命令进行安装,依赖三方库会存储在当前目录的 oh_modules 目录下。

ohpm install

执行以下命令进行安装,将在 oh-package.json5 文件中自动添加依赖。

ohpm install ./package.har

如何在项目中使用三方库

如果将三方库安装到 oh_modules 目录中,就可以使用它了。如果您要创建模块,您可以直接引入三方库,以便在模块中使用此三方库。

示例:

import { CryptoJS } from '@ohos/crypto-js'

var hash = CryptoJS.MD5("123456")

创建三方库

如何创建三方库?这里总结下。官网总结的这方面的资料很少,我一开始竟找不到创建三方库的入口。其实打开DevEco Studio,直接创建新工程,是没有单独创建库的模板的。所以新建个空的EntryAbility工程即可,然后再新建Module(只有新建了EntryAbility工程的前提下才能够新建Module,File->New->Module, 选择Static LIbrary模板)。

oh-package.json5介绍

这里是依赖库的一些发布信息。示例如下:

{
  "types": "",
  "keywords": [
    "jsbn",
    "OpenHarmony",
    "HarmonyOS"
  ],
  "author": "hihope",
  "description": "jsbn(JavaScript BigInteger Library)是一个用于JavaScript环境中的大整数(BigInteger)计算的开源库。本软件是移植开源软件jsbn源码在OpenHarmony上进行功能适配。jsbn,javascript big number,",
  "ohos": {
    "org": "opensource"
  },
  "main": "index.ts",
  "repository": "https://gitee.com/yyz116/jsbn",
  "type": "module",
  "version": "1.0.0",
  "dependencies": {},
  "tags": [
    "Tools",
    "Security"
  ],
  "license": "MIT",
  "devDependencies": {},
  "name": "@yyz116/jsbn"
}

发布三方库

准备工作

首先到 OpenHarmony 三方库中心仓 注册账号,进入到个人中心页面。

HarmonyOS 鸿蒙应用开发(九、还是蓝海,如何贡献第三方库)_第3张图片

1.执行 ssh-keygen -m PEM -t RSA -b 4096 -f your_key_path 生成公私钥对,再在个人中心 ->认证管理 -> 新增,填入公钥内容。

2.执行 ohpm config set key_path your_key_path 配置私钥路径。

3.个人中心 头像下方,点击复制发布码。

4.执行 ohpm config set publish_id your_publish_id 配置发布码。

准备工作完成。

OHPM 公钥

OpenHarmony 三方库中心仓 和 ohpm-cli 命令行工具的通信(查询、下载、发布),需要建立可信的安全通道,可以按如下步骤进行配置 OHPM 公钥。

在进行 publish 发布前,请先确保在OpenHarmony三方库中心仓上已经创建了帐号,且利用工具 ssh-keygen 生成公、私钥文件,可执行以下命令:

ssh-keygen -m PEM -t RSA -b 4096 -f ~/.ssh_ohpm/id_rsa

说明: ~/.ssh_ohpm/id_rsa为私钥文件id_rsa的文件路径,按照实际情况指定。指定的私钥存储目录必须存在。追加了.pub后缀的相应公钥文件会在与私钥相同的目录中生成。需要注意的是,必须得设置passphrase,否则后面推送库时会提示ohpm ERROR: You must config a encrypted private key using a non-empty passphrase.

ohpm ERROR: Private key without passphrase is not supported.
ohpm ERROR: You must config a encrypted private key using a non-empty passphrase.
ohpm ERROR: Not supported private key.
ohpm config set key_path ~/.ssh/ohpm/id_rsa

HAR 中需要导出的组件/接口,除了常规的 export 修饰符之外,还需要在 Index.ets 中进行声明。

import jsbn from "./src/main/js/index"

export default jsbn;

export { jsbn };

然后配置到 oh-packages.json5 文件中:

{ "main": "Index.ets" }

 其他的一些项目配置:

  1. README.md: 必须包含包的介绍和引用方式,如果没有包含安装命令 ohpm install xxx ,审核会被拒
  2. CHANGELOG.md : 更新记录
  3. LICENSE文件

完整介绍在这里: ohpm.openharmony.cn/#/cn/help/c…

发布

首先要构建 HAR 产物,选中依赖库的 module,工具栏 Build -》 Make,产物在依赖库 Module 的 build/default/outputs/default/xxx.har

执行发布命令,发布过程中会要求输入密码。

ohpm publish

HarmonyOS 鸿蒙应用开发(九、还是蓝海,如何贡献第三方库)_第4张图片

避坑指南

在创建库的时候,官方文档介绍只是说在Dev Studio的File->New->Module,选择Static Library就行了。但是需要新建Application, 如新建个Empty Ability的工程才行。不过也没关系,可以在这个空的Ability做些单元测试。

ssh-keygen 生成公、私钥文件的时候,注意必填passphrase。

还有就是发布的时候,不出意外的话,应该就发布成功了。但一般情况,肯定是会发生意外的。

如果你遇到这个错误:

说明你在 oh-package.json 文件中的 name 属性填写的组织未经过认证。比如我填写的是 @yyz116/jsbn,yyz116这个组织就是未经认证的。

但也不麻烦,申请一下就行。到 OpenHarmony 三方库中心仓 的 个人中心 -》组织管理 -》新增,然后等到审核通过。

还有就是library库的目录下,除了oh-package.json5文件不能少,另外CHANGELOG.md,LICENSE,README.md等文件也必须得有。

发布成功后,在OpenHarmony 三方库中心仓的管理界面会收到通知。 

HarmonyOS 鸿蒙应用开发(九、还是蓝海,如何贡献第三方库)_第5张图片

单元测试框架使用

DevEco Studio支持应用/服务测试框架,包含HarmonyOS Test、HarmonyOS JUnit、OpenHarmony Test测试能力。提供测试用例执行能力,提供用例编写基础接口,输出测试结果,支持用户开发简洁易用的自动化测试脚本,支持代码覆盖率统计。

OpenHarmony Test:测试用例存放在ohosTest测试目录下,需要运行在设备或者模拟器上。OpenHarmony Test支持ArkTS/JS语言。适用范围:API 9~ Hvigor工程。

arkTS测试框架工程结构

在Deveco Studio开发工具新建的arkUI项目里,ohosTest目录负责存放测试代码及相关文件。测试模块所在路径如下图所示,测试相关文件及其功能如下表所示。其中default目录是新建ability项目时自动生成的,用户无需修改。test目录下存放各个测试文件,用户可以在此目录下自定义测试用例。

图1 用例路径一览图

HarmonyOS 鸿蒙应用开发(九、还是蓝海,如何贡献第三方库)_第6张图片

表2 测试相关文件说明表

文件名称

功能

ohosTest

存放测试相关文件

jsbn-test.test.ets

测试文件,后缀为xxxx.test.ets

List.test.ets

测试用例加载文件,执行指定测试文件,新增的测试用例文件需要在这里新增引用

用例编写命名建议

测试工程目录及文件夹统一采用小写英文风格命名,不允许出现中文,参考“ohosTest”、“default”。

测试文件以“xx.test.ets”,前缀的“XX”名称为英文字母、数字、下划线的组合,以字母开头,遵从大驼峰命名法,例如“Example.test.ets”。测试文件在同一测试工程中应保持唯一,避免重复。

注意

不能使用逗号、横线、空格以及\ / : * ? “”< > | ()&等特殊字符。

测试套名与测试用例名同上命令规范,保持名称的唯一性。

用例编写基础语法

测试用例遵循 ES6 标准,describe 代表一个测试套, it 代表一条用例,describe 支持多层嵌套。

  • describe:定义一个测试套,支持两个参数: 测试套名称和测试套函数; describe 支持嵌套, 每个 describe 内均可以定义 beforeAll 、beforeEach 、afterEach 和 afterAll。
  • beforeAll:在测试套内定义一个预置条件,在所有测试用例开始前执行且仅执行一次,支持一个参数:预置动作函数。
  • beforeEach:在测试套内定义一个单元预置条件,在每条测试用例开始前执行,执行次数与 it 定义的测试用例数一致,支持一个参数:预置动作函数。
  • afterEach:在测试套内定义一个单元清理条件,在每条测试用例结束后执行,执行次数与 it 定义的测试用例数一致,支持一个参数:清理动作函数。
  • afterAll:在测试套内定义一个清理条件,在所有测试用例结束后执行且仅执行一次,支持一个参数:清理动作函数。
  • it:定义一条测试用例,支持三个参数:用例名称,过滤参数和用例函数。
  • expect:支持 bool 类型判断等多种断言方法。

写在最后

  • 如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:
  • 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力。
  • 关注博主,同时可以期待后续文章ing,不定期分享原创知识。
  • 想要获取更多完整鸿蒙最新VIP学习资料,请关注猫哥公众号【猫青年】,回复“鸿蒙”获取

我的鸿蒙库

一缕阳光116/jsbn

其他资源

OpenHarmony三方库中心仓

OpenHarmony_har_usage.md · OpenHarmony-TPC/docs - Gitee.com

HarmonyOS 鸿蒙开发测试:单元测试框架-CSDN博客

HarmonyOS ArkUI 框架的实现原理和落地实践 - 知乎

https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/jsbn/index.d.ts

https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/sm-crypto

DevEco Marketplace

如何发布鸿蒙三方库 - 掘金

如何创建 HAR 来自 OpenHarmony 网站

发布 HAR 来自 HarmonyOS 网站

创建及发布三方库  OpeOpenHarmony三方库中心仓rmony三方库中心仓

你可能感兴趣的:(HarmonyOS极简教程,harmonyos,华为,OpenHarmony,三方库)