当前位置：首页 > article >正文

鸿蒙NEXT开发-鸿蒙三方库

article 2025/2/12 3:57:38

基本介绍

三方库是开发者在系统能力的基础上进行了一层具体功能的封装，对其能力进行拓展，提供更加方便的接口，提升开发效率的工具。

我们在之前的课程中学习过如何安装三方库axios了，我们大家可以通过ohpm install @ohos/axios进行三方库axios的安装，也可以使用ohpm uninstall @ohos/axios进行三方库的卸载。

OHPM（OpenHarmony Package Manager）由OpenHarmony三方库中心仓网站、命令行工具、OpenHarmony三方库中心仓仓库三个部分组成，其功能如下：

OpenHarmony三方库中心仓网站（website）：用于检索、查看所需 OpenHarmony 三方库信息，也可管理关于 ohpm 的个人配置
命令行工具（cli）：OpenHarmony 三方库的包管理工具
OpenHarmony三方库中心仓仓库（registry）：存储三方库软件及其元数据的仓库，其地址为：https://ohpm.openharmony.cn/ohpm

三方库中心仓的地址：OpenHarmony三方库中心仓，我们可以在这里面查看到多种多样的三方库。

开发一个三方库

如需发布一个 har 包，必须包含 oh-package.json5、README.md，CHANGELOG.md 和 LICENSE 四个文件，若文件缺失，会导致上架至中心仓失败。

HAR（Harmony Archive）是静态共享包，可以包含代码、C++库、资源和配置文件。通过HAR可以实现多个模块或多个工程共享ArkUI组件、资源等相关代码。HAR不同于HAP，不能独立安装运行在设备上，只能作为应用模块的依赖项被引用。

1、创建一个新的工程项目

2、创建库模块，选择static library

鼠标移到工程目录顶部，单击右键，选择New > Module，在工程中添加模块。
在Choose Your Ability Template界面中，选择Static Library，并单击Next。

创建完成后，会在工程目录中生成库模块及相关文件。

3、对所创建的库模块进行开发，需要完善库模块中生成的 oh-package.json5 文件

OpenHarmony 三方库命名规范：

格式为：@group/packagename 或 packagename，长度：[1, 128]，全局唯一，即一个应用中，不同 package 的 package name 不能重名；
name 中只有在存在组织名称 group 时，才能有且仅能有一个'@'符号，有且仅有一个路径分隔符'/'；
组织名称 group 格式：
（1）仅允许以小写字母开头，可由小写字母、数字、中划线(-)、下划线(_)组成。
（2）禁止以中划线（-）、下划线（_）结尾。
（3）不允许为 ArkTS 的保留关键字。
packagename 格式：
（1）仅允许以小写字母开头，可由小写字母、数字、点（.）、中划线（-）、下划线（_）组成。
（2）禁止以点（.）、中划线（-）、下划线（_）结尾。
（3）不允许为 ArkTS 的保留关键字。
建议三方库名称携带组织名称 group，便于管理和识别三方库。

当您选择三方库名称时，请满足 OpenHarmony 三方库命名规范，同时也请选择名称是：

独特的；
有描述性的；
符合正常条例的，例如，请不要给您的三方库起一个冒犯性的名字，也不要使用别人的商标名。

此外，在为未加命令空间的三方库选择名称时，还请选择一个名称：

尚未归他人所有；
与另一个三方库名称的拼写方式不同；
不会混淆其他作者身份。

{
  "license": "Apache-2.0",
    "devDependencies": {},
  "keywords": [
    "OpenHarmony",
    "HarmonyOS",
    "file",
    "fileUpload",
    "upload",
    "image",
    "download"
  ],
    "ibestservices": {
    "org": "opensource"
  },
  "author": "ibestservices",
    "name": "@ibestservices/file_operation",
    "description": "A harmonyos plugin for file and image upload download",
    "main": "index.ets",
    "repository": "https://gitee.com/ibestservices/file_operation.git",
    "version": "4.0.0",
    "dependencies": {},
  "tags": [
    "file_operation"
  ]
}