当前位置:首页 > 系统教程 > 正文

HarmonyOS Next 开发进阶:DevEco Studio 构建 HAR 包全指南 (Harmony Archive 模块打包教程)

HarmonyOS Next 开发进阶:DevEco Studio 构建 HAR 包全指南 (Harmony Archive 模块打包教程)

HarmonyOS Next 的开发过程中,随着项目规模的扩大,代码复用变得至关重要。HAR(Harmony Archive)是鸿蒙静态共享包,可以包含代码、C++库、资源和配置文件。通过将通用功能封装成 HAR 包,我们可以显著提高开发效率。本文将详细教你如何在 DevEco Studio 中创建并构建HAR

一、什么是 HAR 包?

HAR 是鸿蒙系统的库模块打包结果。与应用态的 HAP 不同,HAR 不能直接安装在设备上,而是作为依赖项被其他模块引用。对于小白开发者来说,你可以把它理解为一个“工具箱”,里面装好了写好的代码和UI组件,拿来即用。

HarmonyOS Next 开发进阶:DevEco Studio 构建 HAR 包全指南 (Harmony Archive 模块打包教程)  DevEco 构建HAR 鸿蒙共享包 第1张

二、在 DevEco Studio 中创建库模块

要构建 HAR,首先需要创建一个 Static Library 类型的模块:

  • 打开你的 HarmonyOS 项目,在工程目录右键点击 File -> New -> Module
  • 选择 Static Library 模板。
  • 输入模块名称(例如:MySharedLibrary),点击 Finish。

三、编写并导出功能代码

HarmonyOS Next 要求 HAR 包内想要被外部调用的类或方法必须显式导出。

1. 在库模块的 src/main/ets/components 下编写你的组件。

2. 关键步骤:在库模块根目录下的 Index.ets 文件中导出这些内容:

 // Index.ets 导出示例 export { MyComponent } from './src/main/ets/components/MainPage' 

四、执行构建 HAR 操作

完成代码编写后,即可开始构建HAR包:

  1. DevEco Studio 顶部的菜单栏中,点击 Build
  2. 在下拉菜单中选择 Make Module '你的模块名'
  3. 等待构建任务完成,DevEco Studio 会在底部的控制台提示构建成功。

五、查看生成的 HAR 文件

构建完成后,你可以在以下路径找到产物:

路径:[工程目录] -> [库模块名称] -> build -> default -> outputs -> har

这里的 .har 文件就是你的鸿蒙共享包产物,你可以将其拷贝到其他项目中,通过 oh-package.json5 进行引入使用。

总结

本章我们学习了在 HarmonyOS Next 开发中如何利用 DevEco Studio 构建 HAR 包。掌握这一技能是实现代码模块化、组件化的核心。希望这篇详细的教程能帮助各位小白开发者顺利开启鸿蒙开发进阶之路!