鸿蒙中 HAR/HSP 共享包的引用方式

最新推荐文章于 2025-12-17 21:43:36 发布
原创 最新推荐文章于 2025-12-17 21:43:36 发布 · 736 阅读 · 10 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#harmonyos #华为 #鸿蒙 #依赖管理 #共享包管理

本文同步发表于我的微信公众号，微信搜索 程语新视界 即可关注，每个工作日都有文章更新

一、三方 HAR 引用方式

支持三种引用方式：

  1. 从 ohpm 仓库安装（远程仓库）

  2. 从本地文件夹安装（本地模块源码）

  3. 从本地压缩包安装（本地 HAR/HSP 包）

二、仓库配置与设置

2.1 配置仓库地址

在 Terminal 中执行：

ohpm config set registry your_registry1,your_registry2

说明：

  • 支持配置多个仓库地址，用英文逗号分隔

  • DevEco Studio 默认使用 OpenHarmony 三方库中心仓

  • 首次配置环境变量后需要重启 DevEco Studio

2.2 依赖配置方式

方式一：可视化界面

  • 菜单栏：Tools > OHPM Index

  • 进入内置的 OpenHarmony 开源中心仓

  • 可视化选择和管理三方包

方式二：命令行安装
# 切换到目标模块目录
cd path/to/your/project/entry
# 安装指定包
ohpm install @ohos/animations

效果：自动在 oh-package.json5 中添加依赖

方式三：手动配置依赖

在模块的 oh-package.json5 中：

"dependencies": {
  "@ohos/animations": "^2.1.0"
}

配置后需要执行：

ohpm install

三、引用本地模块源码

前提：本地模块必须与宿主模块属于同一个工程

方式一：命令行安装
cd path/to/your/project/main
ohpm install ../common-utils
方式二：手动配置

在 oh-package.json5 中：

"dependencies": {
  "common-utils": "file:../common-utils"
}

然后执行：

ohpm install

说明：路径可以是绝对路径或相对于当前 oh-package.json5 的相对路径

四、引用本地 HAR/HSP 包

4.1 HAR 包引用

方式一：命令行安装
cd path/to/your/project/main
ohpm install ../libs/ui-components.har
方式二：手动配置
"dependencies": {
  "ui-components": "file:../libs/ui-components.har"
}

4.2 HSP 包引用

HSP 包是通过 HSP 模块在 release 模式下编译生成的 .tgz 文件

方式一：命令行安装
cd path/to/your/project/main
ohpm install ../output/data-service.tgz
方式二：手动配置
"dependencies": {
  "data-service": "file:../output/data-service.tgz"
}

安装执行

两种方式配置后都需要执行：

ohpm install

依赖包会安装到模块的 oh_modules 目录下

五、生命周期钩子管理

在 oh-package.json5 中可配置安装/卸载钩子：

"hooks": {
  "preInstall": "echo '开始安装依赖前执行'",
  "postInstall": "echo '依赖安装完成后执行'",
  "preUninstall": "echo '开始卸载依赖前执行'", 
  "postUninstall": "echo '依赖卸载完成后执行'"
}

说明：

  • 目前只支持执行当前模块或工程的钩子

  • 不支持执行依赖包中的钩子

六、使用 OpenHarmony 开源中心仓（可视化管理）

6.1 访问方式

  • 菜单栏：Tools > OHPM Index

  • 区域限制：仅支持中国境内

6.2 主要功能

搜索与浏览

  • 左侧搜索框：按名称搜索三方包

  • 目录树分类：按功能分类浏览推荐依赖包

安装流程

  1. 选择需要的三方包

  2. 点击右上角 Install 按钮

  3. 如出现弹窗，点击 Add 将中心仓地址添加到 .ohpmrc

依赖管理

  • 查看已安装的三方包及版本信息

  • Update 按钮：更新到最新版本

  • Delete 按钮：删除已安装的三方包

智能替换

对于已使用的依赖，如果存在推荐的同类三方包：

  • Replace selected with recommended library：替换当前选中的依赖

  • Replace all with recommended libraries：一键替换文件中所有同类推荐包

七、注意事项

  1. 依赖声明位置：只在模块和工程级的 oh-package.json5 中声明的 dependencies 才会被构建系统处理

  2. HSP 包生成：HSP 的 .tgz 包需要通过 HSP 模块在 release 模式下编译生成

  3. 依赖名称规范：引用本地 HAR 时，依赖名称建议与三方包的 name 字段保持一致

  4. 路径格式：文件路径支持绝对路径或相对于当前 oh-package.json5 的相对路径

  5. 网络要求：可视化中心仓功能有区域限制，仅在中国境内可用

总结

引用和管理共享包提供了多源支持：

  • 远程仓库：通过 ohpm 命令或可视化界面安装

  • 本地源码：直接引用同一工程内的模块

  • 本地包文件：引用已编译的 HAR/HSP 包文件

管理功能：

  • 生命周期钩子

  • 可视化依赖管理

  • 版本更新和替换

  • 多仓库源配置

鸿蒙 HAP/HAR/HSP，你分清楚了吗？
Dev Blog
07-03 1558
如果应用的功能比较复杂，需要使用 ExtensionAbility 组件，可以采用多 HAP（即一个 entry 包+多个 feature 包）来实现应用开发，每个 HAP 中包含一个 UIAbility 组件或者一个 ExtensionAbility 组件。鸿蒙 App 的项目结构一般为：HAP(主 App) 依赖 HSP(动态库) 或 HAR(静态库)。一般我们的业务模块为创建为 HSP 动态库模式，也是官网建议的模式，主要是可以缩减包体积大小。
三、鸿蒙模块划分，hap/hsp/har三种模块如何选择
zhujian82637的博客
09-01 2265
HAP（Harmony Ability Package）是应用安装和运行的基本单元。HAP包是由代码、资源、第三方库、配置文件等打包生成的模块包，其主要分为两种类型：entry和feature。entry：应用的主模块，作为应用的入口，提供了应用的基础功能。feature：应用的动态特性模块，作为应用能力的扩展，可以根据用户的需求和设备类型进行选择性安装。应用程序包可以只包含一个基础的entry包，也可以包含一个基础的entry包和多个功能性的feature包。
鸿蒙中，HAR 和 HSP的区别
梦想不只是梦与想的博客
08-05 743
摘要： 鸿蒙开发中，HAR（静态共享库）与HSP（动态共享库）是两种共享机制。HAR通过编译时复用代码，支持跨应用共享，性能更优但会增加包体积；HSP通过运行时动态加载实现应用内共享，优化包体积但性能稍弱。HAR适用于工具类等跨应用场景，HSP适合应用内模块复用。开发者可根据性能需求、共享范围及包体积要求选择，二者亦可结合使用以实现资源与性能的平衡。
鸿蒙HarmonyOS中的HAR与HSP文件详解
小北的博客
09-13 3832
在HarmonyOS开发中，HAR与HSP文件是两个非常重要的概念，它们对开发者在模块化开发、组件重用以及分布式应用的管理和分发上提供了极大的便利。本文将详细介绍HAR（HarmonyOS Ability Resource）和HSP（HarmonyOS Service Package）的定义、使用场景以及它们在应用开发中的作用。HAR 是 HarmonyOS 中的模块资源包，其全称是 HarmonyOS Ability Resource。
鸿蒙 动态共享包HSP的创建和引用
懂得就行的博客
07-22 3144
HSP（Harmony Shared Package）是动态共享包，可以包含代码、C++库、资源和配置文件，通过HSP可以实现代码和资源的共享。HSP不支持独立发布，而是跟随其宿主应用的APP包一起发布，与宿主应用同进程，具有相同的包名和生命周期。说明：应用内HSP：在编译过程中与应用包名（bundleName）强耦合，只能给某个特定的应用使用。集成态HSP：构建、发布过程中，不与特定的应用包名耦合；使用时，工具链支持自动将集成态HSP的包名替换成宿主应用包名。
鸿蒙(HarmonyOS)实战开发篇——har和hsp的转换
lc748258的博客
10-06 1155
2.（可选）当Hsp需要对外声明router可跳转的page时，需要添加module.json5的"pages"字段，并在resources/base目录下建立profile/main_pages.json文件，添加配置参考如下，并在对应位置添加页面。4.har包的build-profile.json5默认会有"consumerFiles": ‘./consumer-rules.txt’ ，该项仅har模块可配置，为默认导出的混淆规则（详细描述见： 代码混淆 ），需将其删除。共享包选型： 应用模块化选型。
【HarmonyOS Next】鸿蒙中App、HAP、HAR、HSP概念详解
路漫漫亦无涯
03-19 2221
综上所述，HAR 是静态共享包，HSP 是动态共享包，它们和 HAP（应用的基本功能模块）一起被打包成 App Pack（应用发布形态）用于应用的发布与分发。
静态共享包HAR的创建和引用
懂得就行的博客
07-19 2032
HAR(Harmony Archive）是静态共享包，可以包含代码、C++库、资源和配置文件。通过HAR可以实现多个模块或多个工程共享ArkUI组件、资源等相关代码。HAR不同于HAP，不能独立安装运行在设备上，只能作为应用模块的依赖项被引用。
鸿蒙——应用程序包HAP、HAR、HSP
priest44的博客
06-19 5167
在基于Stage模型开发的应用项目代码下，都存在一个app.json5配置文件、以及一个或多个module.json5配置文件。app.json5配置文件主要包含以下内容：应用的全局配置信息，包含应用的Bundle名称、开发厂商、版本号等基本信息。特定设备类型的配置信息。module.json5配置文件主要包含以下内容：Module的基本配置信息，包含Module名称、类型、描述、支持的设备类型等基本信息。应用组件信息，包含UIAbility组件和ExtensionAbility组件的描述信息。
鸿蒙Harmony开发中的HAP、HAR、HSP的区别
m0_70749039的博客
06-20 6699
对于普通的用户来说，可能一个普通的应用就等于一个安装文件如安卓下的APK。但是对于Harmony应用开发工程师来讲，一个应用包含的内容仅仅不止于此。
【鸿蒙实战开发】har和hsp的转换
MNXN666的博客
07-22 832
2.（可选）当Hsp需要对外声明router可跳转的page时，需要添加module.json5的"pages"字段，并在resources/base目录下建立profile/main_pages.json文件，添加配置参考如下，并在对应位置添加页面。4.har包的build-profile.json5默认会有"consumerFiles": ‘./consumer-rules.txt’ ，该项仅har模块可配置，为默认导出的混淆规则（详细描述见： 代码混淆 ），需将其删除。
鸿蒙 Flutter 日志系统：分级日志与鸿蒙 Hilog 集成
song501的博客
12-12 794
本文介绍了在鸿蒙(HarmonyOS)生态下为Flutter应用构建集成Hilog日志系统的完整方案。针对Flutter原生日志功能简陋和无法直接调用鸿蒙系统日志的问题，通过MethodChannel实现跨平台通信，将Flutter日志分级映射到鸿蒙Hilog。方案包含四个关键部分：1)鸿蒙Hilog基础配置与使用；2)Flutter侧分级日志工具类封装；3)通过MethodChannel实现Flutter与原生Hilog的集成；4)日志系统优化，包括环境差异化配置、本地持久化和日志上报。该方案既保留了Fl
鸿蒙原生系列之动画效果（属性动画）
御承扬的博客
12-14 893
本文介绍如何在 NDK UI 开发方式中，如和借助鸿蒙SDK中的相关API，为组件附加属性动画效果。
初探HarmonyOS应用
liuyang1981228的博客
12-17 645
/ 响应式数据 -> 视图层build里面 this.响应式名 this.响应式名 = 数据。<input typet="text" placeholder="请输入内容" value="默认数据" />Image(图片本地地址) $r('app.media.xxxxxx')Button('各种按钮').type(ButtonType.Normal)// - .alignItems() 交叉轴方向。// - .justifyContent() 主轴方向。
Flutter video_thumbnail 库在鸿蒙（OHOS）平台的适配实践
nanxuan521的专栏
12-15 743
通过上面这个插件的适配案例，我们其实系统性地走了一遍将 Flutter 三方库迁移到鸿蒙平台的完整流程：从环境准备技术原理分析，到鸿蒙原生代码实现，再到集成调试与最后的性能优化。整个过程也再次印证了 Flutter 插件跨平台能力的本质——它通过一套标准化的通道协议，把具体的功能实现“委托”给了各个平台最擅长的原生部分。需要对Flutter 插件架构和OHOS Napi 开发模型都有比较深入的理解。要能精准找到功能对标的原生鸿蒙 API（比如这里的媒体解码和图像处理）。妥善处理异步和内存管理。
uniapp开发鸿蒙：常见问题与踩坑指南
最新发布
ifeng0918的博客
12-17 442
uniapp开发鸿蒙应用虽然存在一些兼容性问题，但通过合理的适配方案和问题排查方法，可以快速解决大部分开发难题。提前规划：在项目初期考虑鸿蒙适配，避免后期大量重构持续学习：关注uniapp官方更新和鸿蒙生态发展充分测试：在不同鸿蒙设备和系统版本上进行全面测试社区求助：遇到问题时，及时在uniapp社区或鸿蒙开发者社区寻求帮助通过本文的踩坑指南，希望能帮助开发者更顺利地完成uniapp鸿蒙应用的开发和上架。
Flutter Provider 状态管理深度解析与开源鸿蒙 ArkUI 状态管理对比
2501_93573639的博客
12-12 1026
Provider 是基于 Flutter实现的状态管理库，它的核心思想是将状态从组件树中抽离，通过依赖注入的方式传递给子组件，实现状态与 UI 的解耦。低侵入性：无需修改组件的继承关系，通过Consumer或即可获取状态。高效刷新：只有依赖状态的组件会重新构建，避免不必要的性能开销。易于集成：支持与Stream等结合，适配不同的状态更新场景。创建文件，定义继承自// 状态数据// 获取状态（对外暴露只读属性）// 状态修改方法_count++;// 通知所有监听者：状态已更新。
Flutter + OpenHarmony 安全与隐私合规实践：构建可信、合规、用户放心的鸿蒙应用
2501_93573294的博客
12-16 664
Flutter + OpenHarmony 安全与隐私合规实践：构建可信、合规、用户放心的鸿蒙应用
鸿蒙跨端协同与Flutter结合的远程办公轻应用开发
2501_94138677的博客
12-13 1083
摘要：本文介绍了鸿蒙分布式能力与Flutter跨平台特性结合开发远程办公应用的方案。通过鸿蒙的分布式数据管理和设备虚拟化，配合Flutter的UI开发，实现多端协同办公功能。详细说明了开发环境配置、数据同步实现、设备虚拟化集成及性能优化策略，并提供了典型业务场景实现方案。该方案已在实际应用中验证，可显著提升协同效率，降低开发成本。欢迎开发者加入开源社区共建生态。
鸿蒙arkts中har包hsp包的区别
09-28
<think>我们之前讨论的是鸿蒙ArkTS中的LRU缓存实现，现在用户询问的是鸿蒙ArkTS中HAR包和HSP包的区别。这是一个全新的问题，需要重新组织答案。 根据鸿蒙官方文档，HAR和HSP都是共享包，但有不同的使用场景和特性。 </think>### 鸿蒙ArkTS中HAR包与HSP包的区别 #### 一、基本定义 | **特性** | **HAR包（静态共享包）** | **HSP包（动态共享包）** | |----------------|--------------------------------------------|--------------------------------------------| | **英文全称** | Harmony Ability Resources | Harmony Shared Package | | **包类型** | 静态共享 | 动态共享 | | **运行方式** | 编译时集成到主包中 | 运行时独立加载 | | **文件扩展名** | `.har` | `.hsp` | #### 二、核心区别 1. **代码共享方式**： - HAR：代码复制到主包，导致多份拷贝占用空间[^1] - HSP：单一实例加载，多应用共享内存中的同一份代码[^2] 2. **依赖关系**： ```mermaid graph TD A[主应用] -->|依赖| B[HAR包] A -->|动态加载| C[HSP包] D[其他应用] -->|依赖| B D -->|动态加载| C ``` 3. **资源隔离**： - HAR：资源ID冲突风险高，需手动管理命名空间 - HSP：自动资源隔离，提供独立资源路径如：`$media:icon.png`[^3] 4. **版本控制**： - HAR：强依赖指定版本，更新需重新编译主应用 - HSP：支持多版本共存，运行时动态选择版本 #### 三、工程结构对比 **HAR包示例**： ``` myLib.har ├── src/main/ets │ ├── utils │ │ └── MathUtil.ets // 工具类 ├── oh-package.json5 // 包声明 ``` **HSP包示例**： ``` myShared.hsp ├── src/main/ets │ ├── entryability │ │ └── EntryAbility.ets // 独立入口 ├── module.json5 // 动态配置 ├── resources │ └── base/media/icon.png // 隔离资源 ``` #### 四、使用场景对比 | **场景** | **推荐方案** | **原因** | |-----------------------|-------------|------------------------------------------| | 通用工具类库 | HAR | 简单轻量，无运行时开销 | | UI组件库 | HSP | 资源隔离需求，多应用共享 | | 多设备适配模块 | HSP | 运行时按设备动态加载不同实现 | | 高频更新业务模块 | HSP | 独立更新，无需重新发布主应用[^4] | #### 五、实战代码示例 **HAR调用方式**： ```typescript // 安装依赖 npm install myLib@1.0.0 --save // 导入使用 import { calculate } from 'myLib' calculate(1, 2); ``` **HSP动态加载**： ```typescript // 检查模块是否存在 import abilityAccessCtrl from '@ohos.abilityAccessCtrl'; let atManager = abilityAccessCtrl.createAtManager(); atManager.checkAccessToken('com.example.myshared').then(() => { // 动态加载模块 import('com.example.myshared').then((module) => { module.showCustomDialog(); }); }); ``` #### 六、性能对比 $$ \text{内存占用} = \begin{cases} n \times \text{HAR\_size} & \text{(HAR)} \\ \text{HSP\_size} & \text{(HSP)} \end{cases} $$ $$ \text{启动耗时} = \begin{cases} \text{主包加载时间} & \text{(HAR)} \\ \text{主包加载} + \text{HSP动态加载} & \text{(HSP)} \end{cases} $$ #### 七、选择建议 1. **选HAR当**： - 简单工具函数集合 - 无资源文件 - 调用频率低的小型库 2. **选HSP当**： - 包含UI组件或资源文件 - 需多应用共享 - 需热更新能力 - 模块体积较大（>1MB） #### 八、演进路径 ```mermaid graph LR A[单一应用] --> B[提取HAR工具包] B --> C[复杂模块转为HSP] C --> D[跨设备HSP共享] ``` > 注：HSP是鸿蒙3.1+版本引入的特性，需API 9+支持[^5]
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值