HAP转HAR指导

HAP不支持导出接口或ArkUI组件给其他模块或应用使用，如果需要导出模块中的接口或ArkUI组件，并将模块作为二方库、三方库共享给其他模块或应用，可以使用HAR。本文介绍如何通过配置项的变更将HAP工程变成HAR工程。

说明：

部分组件和模块在HAP、HSP、HAR中集成使用时存在差异，例如加载HAR中Worker线程文件相比HSP存在单独的使用约束，因此按照如下步骤完成HAP转HAR后，请关注对应组件和模块介绍并进行适配。

HAP转HAR的操作步骤

1. 修改HAP模块下的module.json5文件，具体操作如下：

   • 将type标签值改为har，删除mainElement、deliveryWithInstall、installationFree和pages标签。
   • 由于API version 17及之前版本HAR不支持创建任何ExtensionAbility，从API version 18开始HAR仅支持创建两种ExtensionAbility，因此在API version 18及之后版本但未配置为支持的两种ExtensionAbility、或在API version 17及之前版本，需要删除extensionAbilities标签，并将关联的ExtensionAbility组件删除或迁移到其他HAP模块中。
   • 由于HAR模块在API version 13及以下不支持UIAbility，因此在API version 13及以前的版本，需要删除abilities标签，并将关联的UIAbility组件删除或迁移到其他HAP模块中。

   {
     "module": {
       "name": "har",
       "type": "har",
       "deviceTypes": [
         "tablet",
         "2in1"
       ]
     }
   }
   

   module.json5

2. 在HAP模块的src\main\resource\base\profile文件夹下，删除main_pages.json文件。

3. 修改HAP模块的hvigorfile.ts文件，将内容替换为以下内容：

   import { harTasks } from '@ohos/hvigor-ohos-plugin';
   
   export default {
     system: harTasks,  // 修改成HAR编译任务
     plugins:[]
   }
   

   hvigorfile.ts

4. 在HAP模块的根目录下创建名为Index.ets的文件，并在模块的oh-package.json5文件中的main标签配置该文件。Index.ets文件用于导出ArkUI组件或接口，详细导出方法参见HAR-开发。

   {
     // ...
     "main": "Index.ets",
     // ...
   }
   

   oh-package.json5

5. 修改项目级的配置文件build-profile.json5，在 modules 标签下找到HAP的配置信息，并删除HAP配置下的 targets。