一、什么是HAR

HAR（Harmony Archive）是静态共享包，可以包含代码、C++库、资源和配置文件。通过HAR可以实现多个模块或多个工程共享ArkUI组件、资源等相关代码。

二、什么情况下使用HAR

• 作为二方库，发布到OHPM私仓，供公司内部其他应用使用。
• 作为三方库，发布到OHPM中心仓，供其他应用使用。

三、HAR的限制

• HAR不支持在设备上单独安装/运行，只能作为应用模块的依赖项被引用。
• HAR不支持在配置文件中声明UIAbility组件与ExtensionAbility组件。
• HAR不支持在配置文件中声明pages页面，但是可以包含pages页面，并通过命名路由的方式进行跳转。
• HAR不支持引用AppScope目录中的资源。在编译构建时，AppScope中的内容不会打包到HAR中，因此会导致HAR资源引用失败。
• HAR可以依赖其他HAR，但不支持循环依赖，也不支持依赖传递。

四、HAR的创建和使用

• 创建：通过DevEco Studio创建一个HAR模块，详见创建库模块。

• 使用：引用HAR前，需要先配置对HAR的依赖，详见引用HAR文件和资源。

HAR的依赖配置成功后，可以引用HAR的ArkUI组件。ArkUI组件的导入方式与ts的导入方式一致，通过import引入HAR导出的ArkUI组件

五、编译

HAR可以作为二方库和三方库提供给其他应用使用，如果需要对代码资产进行保护时，建议开启混淆能力。

混淆能力开启后，DevEco Studio在构建HAR时，会对代码进行编译、混淆及压缩处理，保护代码资产。

注意：

• 编译HAR时，如果没有开启混淆能力，编译后的产物是源码文件。

• 仅Stage模型的ArkTS工程支持混淆。

• HAR开启混淆后资源ID为-1，ResourceManager等通过ID获取资源的API不再生效。

• 从DevEco Studio 5.0.3.600开始，新建工程默认关闭代码混淆功能，可以在HAR模块的build-profile.json5文件中的ruleOptions字段下的enable进行开启混淆，详情请见代码混淆。

六、发布

详见发布HAR。