logo
积分中心
HarmonyOS 工程级一多的 HAR/HSP 拆分策略与编译隔离 原创
头像 不秃也能写代码 2026-11-17 13:31:30    发布
0 浏览 0 收藏

“一次开发,多端部署”在工程层面的落地,核心不是写响应式布局,而是把代码按设备差异拆到正确的模块粒度。官方推荐的三层架构中,common 编译为 HAR/HSP 共享包,features 封装独立业务模块,products 为每类设备生成独立的 Entry HAP。但实际项目中,拆分的边界往往比架构图复杂得多。

HAR 与 HSP 的选择依据

HAR(静态共享库)在编译时被调用方打包进 HAP,适合体积小、变更频率低的工具类和常量模块。HSP(动态共享库)在运行时动态加载,适合体积较大、多个 HAP 共享的组件库或数据层。

一个常见的误判是把所有 common 模块都做成 HAR。如果 common 中包含图片资源或较大的 JSON 配置,每个引用它的 HAP 都会复制一份,最终导致 APP Pack 体积膨胀。以下判断规则在实践中比较可靠:

  • 纯逻辑(工具函数、数据模型、网络封装):HAR,体积小,无副作用。
  • 含 UI 组件或资源(通用弹窗、图标库):HSP,避免资源重复打包。
  • 仅被单个 HAP 引用的模块:直接放在该 HAP 内部,不做共享包。

设备专属代码的编译隔离

products 层按设备拆分为多个 Entry HAP 时,设备专属的页面和资源只应存在于对应的 HAP 中。但业务逻辑中偶尔会出现“只有某类设备才需要调用的方法”,如果把这些方法放在 features 层,会导致其他设备的包中也包含无用代码。

ArkTS 的 import 是静态解析的,无法像 C++ 那样通过宏做条件编译。可行的做法是把设备专属逻辑下沉到 products 层,通过接口或回调注入到 features 层的通用组件中:

typescript

// features 层:定义能力接口,不关心实现来自哪类设备
export interface DeviceCapability {
  getDeviceSpecificConfig(): Record<string, string>;
}

@Component
export struct SettingsPanel {
  private capability: DeviceCapability;

  aboutToAppear() {
    const config = this.capability.getDeviceSpecificConfig();
    // 使用配置
  }
}

// products/phone 层:手机端的实现
export class PhoneCapability implements DeviceCapability {
  getDeviceSpecificConfig(): Record<string, string> {
    return { layout: 'single-column', vibrate: 'true' };
  }
}

// products/tablet 层:平板端的实现
export class TabletCapability implements DeviceCapability {
  getDeviceSpecificConfig(): Record<string, string> {
    return { layout: 'two-column', vibrate: 'false' };
  }
}

features 层的 SettingsPanel 只依赖 DeviceCapability 接口,编译时不会引入任何 products 层的代码。每个 products 子目录在编译时只包含自己的实现,不会污染其他设备的 HAP。

编译产物验证

拆分完成后,建议用 app_packing_tool 或 DevEco 的构建分析功能查看每个 HAP 的代码构成。重点确认两个指标:common 的 HAR 是否被重复打入多个 HAP(对比各 HAP 中同名模块的哈希值),以及 products 子目录之间是否存在意外的交叉依赖(products/phone 的代码中是否 import 了 products/tablet 的路径)。


©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

头像

不秃也能写代码

我还没有写个人简介......

11

帖子

5

提问

0

粉丝

关注
地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255