贡献 OpenHarmony 库关键配置

作者：飞龙AI

2025-05-29
四川
本文字数：3182 字
阅读完需：约 10 分钟

贡献 OpenHarmony 库关键配置 #自研框架 #ArkUI-X#三方框架 #OpenHarmony#HarmonyOS

创建第三方库

打开 DevEco Studio 创建一个项目，然后创建一个库模块，选择 static library。详细步骤可参考：开发静态共享包。

在项目内会生成 library 文件夹

对所创建的库模块进行开发，需要完善库模块中生成的 oh-package.json5 文件，有关三方库名称的规则，请参阅三方库名称指南章节，其他配置项的设置请参考 oh-package.json5 配置说明。

目录分析

  library  // HAR根目录  ├─libs  // 存放用户自定义引用的Native库，一般为.so文件f  └─src  │   └─main  │     ├─cpp  │     │  ├─types  // 定义Native API对外暴露的接口  │     │  │  └─liblibrary  │     │  │      ├─index.d.ts  │     │  │      └─oh-package.json5  │     │  ├─CMakeLists.txt  // CMake配置文件  │     │  └─napi_init.cpp  // C++源码文件  │     └─ets  // ArkTS源码目录  │     │  └─components  │     │     └─MainPage.ets  │     ├─resources  // 资源目录，用于存放资源文件，如图片、多媒体、字符串等  │     └─module.json5  // 模块配置文件，包含当前HAR的配置信息  ├─build-profile.json5  // Hvigor编译构建所需的配置文件，包含编译选项  ├─hvigorfile.ts  // Hvigor构建脚本文件，包含构建当前模块的插件、自定义任务等  ├─Index.ets  // HAR的入口文件，一般作为出口定义HAR对外提供的函数、组件等  └─oh-package.json5  // HAR的描述文件，定义HAR的基本信息、依赖项等

复制代码

library/build-profile.json5 建议开启代码混淆

{  "apiType": "stageMode",  "buildOption": {},  "buildOptionSet": [    {      "name": "release",      "arkOptions": {        // 混淆相关参数        "obfuscation": {          "ruleOptions": {            // true表示进行混淆，false表示不进行混淆。5.0.3.600及以上版本默认为false            "enable": true,            // 混淆规则文件            "files": ["./obfuscation-rules.txt"]          },          // consumerFiles中指定的混淆配置文件会在构建依赖这个library的工程或library时被应用          "consumerFiles": ["./consumer-rules.txt"]        }      }    }  ],  "targets": [    {      "name": "default"    }  ]}

复制代码

build-profile.json5 设置 useNormalizedOHMUrl

{  "app": {    "products": [      {        "buildOption": {          "strictMode": {            "useNormalizedOHMUrl": false          }        }      }    ]  }}

复制代码

在库模块的根目录中，创建一个 README.md(不区分大小写) 文件，描述您三方库的代码以及如何使用它，文件不能为空。

README.md 模板

# feilongui
FeilongUI 是一款功能丰富、高效易用的 UI 库，旨在帮助开发者快速构建美观、交互流畅的用户界面。以下是该库的详细使用指南。
## 安装命令
README.md 中未包含安装命令会导致审核失败`ohpm install feilongui`
## 模块介绍
README.md 中缺少简要的三方库使用说明会导致审核失败

复制代码

没有文件会报错

ohpm ERROR: HttpCode 400 The OHPM package must contain a non-empty readme.md file.ohpm ERROR: Publish failed, detail: The "Publish" request to url "https://ohpm.openharmony.cn/ohpm/feilongui" has failed

复制代码

在库模块的根目录中，创建一个 CHANGELOG.md 文件，描述您三方库的代码不同版本的变更内容，文件不能为空。

没有文件会报错

ohpm ERROR: HttpCode 400 The OHPM package must contain a non-empty changelog.md file.ohpm ERROR: Publish failed, detail: The "Publish" request to url "https://ohpm.openharmony.cn/ohpm/feilongui" has failed

复制代码

Changelog.md 模板(CHANGELOG.md 中未包含当前版本，也就是 oh-package.json5 中 version 值的版本。 CHANGELOG.md 由清晰的版本号和该版本的修改内容组成，修改内容不可为空，不然过不了审核)

# Changelog
## 1.0.0
\*\*UnreleasedAdded
- 新增 [按钮]，用于 [点击]。  Changed- 优化 [模块 / 功能名称] 的性能，提升 [具体指标，如响应速度、加载时间等]。  Deprecated- 标记 [某接口 / 方法 / 功能] 为废弃，计划在 [具体版本] 中移除。  Removed- 移除不再维护的 [某功能 / 模块]。  Fixed- 修复 [问题描述] 导致的 [具体错误，如程序崩溃、数据错误等]。  Security- 修复 [名称] 提升系统安全性。

复制代码

在库模块的根目录中，创建一个 LICENSE（不区分大小写）文件，指定该软件包可以在什么样的许可下被使用、修改和共享，文件不能为空。

许可证模板(LICENSE 文件中许可证条款内容和 oh-package.json5 文件中许可证名称不一致会审核失败) 许可证获取地址

Copyright [此处填写年份，如2025] [此处填写在library/oh-package.json5中的name，否则审核失败]
Licensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License at
    http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.

复制代码

没有 LICENSE 文件会报错

ohpm ERROR: HttpCode 400 The OHPM package must contain a non-empty license file.ohpm ERROR: Publish failed, detail: The "Publish" request to url "https://ohpm.openharmony.cn/ohpm/feilongui" has failed

复制代码

在进行 publish 发布前，请先确保在 OpenHarmony 三方库中心仓上已经创建了帐号，且利用工具 ssh-keygen 生成公、私钥文件认证管理地址

ssh-keygen -m PEM -t RSA -b 4096 -f ~/.ssh_ohpm/mykeyohpm config set key_path ~/.ssh_ohpm/mykey

复制代码

不签名发布时会报错

ohpm ERROR: Publish failed, detail: The "key_path" is empty - configure "key_path" in the .ohpmrc file.

不设置密码发布时会报错

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: Publish failed, detail: Not supported private key.

复制代码

不上传公钥(~/.ssh_ohpm/mykey.pub)会报错

ohpm ERROR: HttpCode 400 The publicKey verify failed!ohpm ERROR: Publish failed, detail: The "Login" request to url "https://ohpm.openharmony.cn/ohpm/login" has failed

复制代码

设置 publish_id

不设置 publish_id 会报错

ohpm ERROR: Publish failed, detail: The "publish_id" is empty - configure "publish_id" in .ohpmrc file.

publish_id 设置错误会报错

ohpm ERROR: HttpCode 400 The publishId is invalid!ohpm ERROR: Publish failed, detail: The "Login" request to url "https://ohpm.openharmony.cn/ohpm/login" has failed

复制代码

发布后再发布不更新版本号会报错

ohpm ERROR: HttpCode 400 The OHPM package version already exists.ohpm ERROR: Publish failed, detail: The "Publish" request to url "https://ohpm.openharmony.cn/ohpm/feilongui" has failed

复制代码

利用 DevEco Studio 对开发后的库模块打成 HAR 包。( 详情请见：构建 HAR)

在工具中构建 library 库时需要选中 library 文件夹内的文件构建后所在目录为library/build/default/outputs/default/library-signed.har后续发布需要使用这个路径

发布于: 刚刚阅读数: 6

原文链接:【http://xie.infoq.cn/article/b3e0ab5e4282a25398bfdf828】。文章转载请联系作者。

飞龙AI

关注

还未添加个人签名 2025-03-13 加入

还未添加个人简介

发布

暂无评论

创作场景

贡献 OpenHarmony 库关键配置

贡献 OpenHarmony 库关键配置 #自研框架 #ArkUI-X#三方框架 #OpenHarmony#HarmonyOS

创建第三方库

飞龙AI

评论