鸿蒙跨模块跳转页面(HSP,HAR)

跳转HSP包页面

如果想在模块A跳转模块B的某个页面,通过

router.pushUrl({url: "xxx"})

url路径需要按照以下格式拼接:

@bundle:包名(bundleName)/模块名(moduleName)/页面相对路径(以main文件夹为起点))

例:

@bundle:com.xxx.xxx/debug/ets/pages/Index

注:跳转的页面需要是在模块B中main_pages.json配置过的页面

跳转HAR包页面

如果想在模块A跳转模块B的某个页面,通过

A模块

import("@ohos/har/src/main/ets/components/mainpage/MainPage")// 引入共享包中的命名路由页面
Button("router  to har ")
.onClick(() => { // 点击跳转到其他共享包中的页面
  console.info("22")
    router.pushNamedRoute({
      name: 'xxxxx',
    })
  // router.pushUrl({ url: '@bundle:com.example.router_har/hsp/ets/pages/Index' })
})

A模块中oh-package.json文件下引入har包

"dependencies": {
    "@ohos/har": "../har"
}

B模块

@Entry({ routeName: 'xxxxx' })
@Component
export struct MainPage {
  @State message: string = "har包页面";
  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}
<think>我们正在讨论HarmonyOS中的HARHarmony Ability Resources)和HSPHarmony Shared Package)的区别。根据引用[1]的信息,HSP有一些约束:HSP及其使用方都必须是Stage模型,必须使用esmodule编译模式,且HSP不支持在配置文件中声明abilities、extensionAbilities标签。这些信息可以帮助我们理解HSP的特性。 HARHSP都是HarmonyOS中用于模块化开发的共享包机制,但它们有不同的设计目标和应用场景。 ### HARHarmony Ability Resources) - **定义**:HAR是静态共享包,包含代码、资源文件和配置文件(如`config.json`)。它主要用于共享公共代码和资源,但不包含UI组件(如Ability)。 - **特点**: - 编译时依赖:HAR在编译时被集成到使用方模块中,每个使用方模块都会包含HAR的一份拷贝。 - 资源隔离:HAR中的资源ID会被重新分配,以避免与应用资源冲突。 - 使用简单:不需要特殊的系统支持,只需在`build.gradle`中声明为`har`依赖即可。 - **适用场景**:适用于共享工具类、公共资源等,不涉及运行时动态共享。 ### HSPHarmony Shared Package) - **定义**:HSP是动态共享包,同样包含代码和资源,但它在运行时被多个模块共享,即内存中只有一份实例。 - **特点**: - 运行时共享:多个模块在运行时共享同一个HSP实例,节省内存。 - 独立编译:HSP独立编译,使用方模块依赖HSP时,不需要重新编译HSP。 - 约束条件(根据引用[1]): - 必须使用Stage模型。 - 必须使用esmodule编译模式。 - 不能在配置文件中声明abilities、extensionAbilities标签(即不能包含UI组件)。 - **适用场景**:适用于需要被多个模块频繁调用的公共功能,尤其是当这些功能较大且希望减少内存占用时。 ### 主要区别总结 | **特性** | **HAR** | **HSP** | |------------------|--------------------------------------|--------------------------------------| | **共享方式** | 静态共享(编译时复制) | 动态共享(运行时单实例) | | **资源占用** | 每个使用模块独立占用资源 | 多个模块共享同一份资源 | | **编译模型** | 无特殊要求 | 必须使用Stage模型和esmodule编译模式 | | **UI组件支持** | 不支持Ability(与HSP相同) | 不支持Ability(明确约束) | | **依赖声明** | `implementation project(... har)` | `hsp project(...)` | | **适用场景** | 工具类、公共资源 | 高频调用的大型公共模块 | ### 使用示例 #### 创建HAR 在模块的`build.gradle`中: ```groovy apply plugin: 'com.huawei.ohos.hap' ohos { library { libraryType = "Har" } } ``` #### 创建HSP 在模块的`build.gradle`中: ```groovy apply plugin: 'com.huawei.ohos.hsp' ohos { sharedLibrary { libraryType = "Shared" } } ``` #### 依赖HAR 在使用方模块的`build.gradle`中: ```groovy dependencies { implementation project(path: ':lib_utils', configuration: 'har') } ``` #### 依赖HSP 在使用方模块的`build.gradle`中: ```groovy dependencies { hsp project(':lib_shared') } ``` ### 注意事项 1. **HSP的约束**:由于HSP要求使用Stage模型和esmodule,因此传统的FA模型无法使用HSP。 2. **资源冲突**:HSP中资源ID是全局共享的,因此要避免资源命名冲突。 3. **版本管理**:HSP更新后,所有依赖模块需重新适配,因为运行时使用的是同一份HSP。 > 参考:[HarmonyOS共享包开发指南](https://developer.harmonyos.com)[^1] §§相关问题§§ 1. 如何将现有的HAR模块升级为HSP? 2. 在Stage模型下如何正确使用HSP? 3. 如何解决HSP中的资源ID冲突问题?</think>### HarmonyOS HAR vs HSP 核心区别解析 在 HarmonyOS 开发中,HARHarmony Archive)和 HSPHarmony Shared Package)都是模块化共享机制,但存在本质差异: | **特性** | **HAR (Harmony Archive)** | **HSP (Harmony Shared Package)** | |------------------|------------------------------------|-------------------------------------| | **共享方式** | 静态共享(编译时复制) | 动态共享(运行时加载) | | **资源占用** | 每个使用方独立拷贝 | 多个模块共享同一份内存实例 | | **编译模型** | 无特殊要求 | 必须使用 Stage 模型[^1] | | **模块类型** | 普通模块/Ability模块 | 纯功能模块(无UI能力) | | **依赖声明** | `implementation project(... har)` | `hsp project(...)` | | **资源隔离** | 资源ID自动重映射 | 全局共享资源需特殊处理 | | **热更新支持** | ❌ 不支持 | ✅ 支持动态更新 | #### 关键区别详解 1. **运行机制差异** - **HAR**:编译时被拆解并合并到主模块包中 ```mermaid graph LR A[主模块] --> B[编译时合并HAR] B --> C[生成单一HAP] ``` - **HSP**:独立编译为 `.hsp` 文件,运行时动态加载 ```mermaid graph LR D[主模块] --> E[运行时加载HSP] F[HSP文件] --> E ``` 2. **使用约束** - **HSP** 有严格限制(根据引用[1]): - 必须使用 Stage 应用模型 - 必须开启 `esmodule` 编译模式 - 禁止声明 UI 组件:`abilities`/`extensionAbilities` ```json // 无效的HSP配置(会报错) "abilities": [{ "name": ".MainAbility", "icon": "$media:icon", "label": "MyApplication" }] ``` 3. **性能影响** - **HAR**:增加主包体积,但启动速度快 - **HSP**:减少安装包体积($$ \Delta V = \sum V_{HSP} $$),但首次加载有延迟 4. **适用场景** - **HAR** 适合: - 工具类库 - 公共资源文件 - 小型功能模块 - **HSP** 适合: - 大型公共业务模块 - 需要热更新的功能 - 多应用共享的核心服务 #### 开发建议 1. **优先使用 HAR**:当不需要运行时共享时,HAR更简单高效 2. **HSP 使用原则**: ```groovy // 正确声明方式 dependencies { hsp 'com.example:utils:1.0.0' // 远程HSP hsp project(':lib_shared') // 本地HSP } ``` 3. **资源访问**:HSP中使用全局资源需通过 `$r('app.type.name')` 语法 > 参考:[HarmonyOS共享包开发指南](https://developer.harmonyos.com)[^1]
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值