不秃也能写代码
2026-11-17 13:31:30 发布“一次开发,多端部署”在工程层面的落地,核心不是写响应式布局,而是把代码按设备差异拆到正确的模块粒度。官方推荐的三层架构中,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 的路径)。
暂无评论数据
发布
相关推荐
sky_Qian
0
0
sky_Qian
0
0
sky_Qian
2
0
张妍希
0
0
码上调用
0
0
不秃也能写代码
我还没有写个人简介......
帖子
提问
粉丝
华为余承东:正考虑逐步将鸿蒙推向全球市场
2026-10-08 17:40:02 发布全新体验:钉钉鸿蒙PC版不只变好看,更是让每个操作都“懂你”
2026-08-13 17:04:02 发布


京公网安备:11010502051901号