鸿蒙 ohpm 包管理与 Hypium 测试框架
本文讲清鸿蒙工程的依赖与测试体系:ohpm 仓库与命令行用法、oh-package.json5 字段与版本约束语法、HAR 与 HSP 两种包形态的差异与选型、私仓与 ohpmrc 配置、Hypium 单元测试用例与断言写法、UI 测试、覆盖率统计与 DevEco 运行配置。
category
本文讲清鸿蒙工程的依赖与测试体系:ohpm 仓库与命令行用法、oh-package.json5 字段与版本约束语法、HAR 与 HSP 两种包形态的差异与选型、私仓与 ohpmrc 配置、Hypium 单元测试用例与断言写法、UI 测试、覆盖率统计与 DevEco 运行配置。
本文梳理 ArkUI 的动画与手势两套体系:属性动画与 animateTo 显式动画的差别、关键帧动画、transition 转场与 geometryTransition 共享元素、Tap/Pan/Pinch/Swipe 手势的组合与竞争规则、拖拽与响应区域设置,以及动画丢帧的排查方法。
本文系统梳理 HarmonyOS NEXT 的应用安全实践:system_grant 与 user_grant 两类权限的差异、受限权限 ACL 的申请流程、应用沙箱与数据分级、HUKS 密钥生成与加解密用法、证书与签名校验、网络安全配置与证书锁定,以及代码混淆与加固的取舍。
本文讲清 HarmonyOS NEXT 的运行时跨设备协同:分布式软总线的发现与组网、可信设备认证、跨设备迁移的保存与恢复回调、分布式数据对象与 KV 同步、跨端调用与权限申请,以及多设备协同场景的落地方式、环境依赖判断与优雅降级策略,并附常见坑清单。
本文讲解 ArkTS 与 C/C++ 的原生互操作:NAPI 模块注册方式、napi_value 与 ArkTS 类型的映射规则、同步与异步函数实现、线程安全函数跨线程回调、引用计数与内存陷阱,以及 CMake 与 hvigor 集成原生库、SO 打包与 ABI 选择的完整工程配置。
本文从 Ability 体系分类讲起,覆盖 UIAbility 与 WindowStage 的职责边界、四类 ExtensionAbility 的能力与配置、module.json5 中 abilities 与 extensionAbilities 的字段含义、want 的显式与隐式匹配规则,以及 startAbility 系列接口与 Ability 间传参方式。
本文按启动、渲染、内存、包体积四条主线梳理 HarmonyOS NEXT 的性能优化:DevEco Profiler 泳道与 hdc、hilog 命令行调试,AppStartup 启动框架与延迟加载,@Reusable 组件复用与 LazyForEach 懒加载,@Track 精确刷新与布局扁平化,内存泄漏排查与快照分析,以及混淆与资源精简。
本文梳理 HarmonyOS NEXT 应用上架的完整链路:密钥库、证书请求、数字证书与 Profile 四件套的作用与生成顺序,调试签名与发布签名的差异,AGC 侧的应用创建与调试设备注册,hvigor 打包命令与产物路径,版本号管理规则与审核驳回原因,并汇总 bundleName 不一致、versionCode 未递增等高频坑。
本文讲清 HarmonyOS NEXT 的一次开发多端部署:断点机制与窗口宽度阈值、媒体查询监听、GridRow 与 GridCol 栅格布局、自适应布局的尺寸单位与约束属性、资源限定目录的匹配规则,以及窗口与折叠屏状态管理。文中给出手机单列切换平板双栏的完整示例与两张对照表,并汇总硬编码 px、限定词命名错误等常见坑。
本文讲解 HarmonyOS NEXT 的元服务与服务卡片开发:元服务的免安装特性与包体积约束、FormExtensionAbility 的完整生命周期回调、form_config.json 配置项含义、卡片 ArkTS UI 的组件子集与数据绑定、定时与定点两类刷新机制,以及 postCardAction 的三种交互方式。文中给出可运行代码与两张对照表,并汇总卡片刷新配额、组件受限等常见坑。
本文讲清 HarmonyOS NEXT 的并发模型:ArkTS 主线程如何被耗时任务拖垮,TaskPool 与 Worker 各自适合什么场景。覆盖 @Concurrent 装饰器、Task 对象、TaskGroup、优先级与取消、Worker 的创建与通信、Sendable 对象与 collections 共享容器,并用对照表给出选型依据与高频坑清单。
本文系统讲解 HarmonyOS NEXT 的数据层建设:用 @ohos.net.http 与 WebSocket 完成网络通信,用 Preferences、RelationalStore、distributedKVStore 与文件系统完成本地持久化。给出可复用的 HttpUtil 封装与 RDB 建表、事务示例,并用对照表说明四种存储方案的差异与高频坑。
本文梳理 HarmonyOS NEXT Stage 模型下的应用与页面生命周期。覆盖 UIAbility 的 onCreate、onWindowStageCreate、onForeground、onBackground、onWindowStageDestroy、onDestroy 六个回调,AbilityStage 模块级初始化,三种 launchType 的差异,以及页面与组件生命周期对照。
本文梳理 HarmonyOS NEXT 上 @ohos.router 与 Navigation 两套跳转方案的差异:pushUrl 的 Standard 与 Single 模式、replaceUrl、back、getParams 与错误码,NavPathStack 的注入与 pushPathByName、popToName 用法,NavDestination 配置与自定义转场,以及系统路由表方案。
系统梳理 HarmonyOS NEXT 上 ArkUI 的布局能力:vp、fp、lpx 与百分号的换算关系,Row/Column、Flex、Stack、RelativeContainer、Grid、List 等容器的选型建议,用完整代码演示 LazyForEach 与 IDataSource 的列表优化,并覆盖 @Builder、@Styles 与组件复用池原理。
从命令式到声明式的范式转变切入,讲解 HarmonyOS NEXT 上 ArkUI 的 @Component、@Entry 与 build 结构,逐一剖析 @State、@Prop、@Link、@Provide/@Consume、@Observed/@ObjectLink、@Watch、@Track 的语义,对比四种应用级存储方案,最后落到刷新原理、性能权衡与常见坑清单。
本文从 ArkTS 运行于 ArkVM 与严格模式的定位讲起,梳理基础类型、interface、class、enum、泛型、函数重载、可选链等语言要点,并逐条给出 ArkTS 相对 TypeScript 的限制清单与正反例代码,覆盖禁用 any、禁止结构化类型、禁止动态增删属性、不支持声明合并等关键约束,附 TS 特性支持对照表与常见编译坑清单。
本文系统梳理 HarmonyOS NEXT 与兼容 AOSP 旧版鸿蒙的本质差异、四层系统架构与 Stage 模型核心概念,对比元服务与传统应用的取舍,给出 API 9 至 API 15 的版本演进对照,并逐步完成 DevEco Studio 5.0.3.900 安装、SDK 组件管理、ohpm 与 hvigor 工具链配置、首个工程目录逐文件解读、模拟器创建与自动签名,最后附常见坑清单。
HarmonyOS NEXT 是华为全栈自研的分布式操作系统,彻底移除 AOSP 兼容层后以 ArkTS + ArkUI 构建原生应用生态。本专题覆盖鸿蒙原生开发的完整链路:从 HarmonyOS NEXT 与 DevEco Studio 环境搭建、ArkTS 相对 TypeScript 的静态类型约束、ArkUI 声明式 UI 与状态装饰器、布局系统与自定义组件、Navigation 路由栈与页面生命周期,到网络请求与首选项/关系型数据库持久化、TaskPool 与 Worker 并发模型、元服务与万能卡片、一次开发多端部署的响应式适配、AppGallery 签名打包上架,以及启动耗时、帧率与内存的性能优化与调试。后续补充的 6 篇进阶内容进一步覆盖 Stage 模型与 Ability/Extension 体系、NAPI 与 C/C++ 原生互操作、分布式软总线与跨设备迁移、权限模型与 HUKS 密钥管理、ArkUI 动画与手势交互,以及 ohpm 包管理与 Hypium 测试框架。