HAR转HSP指导

目前HAR的使用存在打包多份，包膨胀的问题，导致整体应用包的体积很大，HSP可以很好地解决该问题，本文介绍了HAR转HSP的步骤，主要是通过配置项的变更将HAR工程变成HSP工程。

HAR转HSP的操作步骤

1. 修改HAR模块下的module.json5文件，修改type字段为shared，新增deliveryWithInstall和pages字段。

   // MyApplication\library\src\main\module.json5
   {
     "module": {
       "type": "shared",
       "deliveryWithInstall": true,
       "pages": "$profile:main_pages"
       // ...
     }
   }
   

2. 在resources下的base，en_US和zh_CN的element下新增一个string字段shared_desc。

   // MyApplication\library\src\main\resources\base\element\string.json
   {
     "string": [
       {
         "name": "shared_desc",
         "value": "description"
       }
     ]
   }
   

3. 在resources\base下新增profile文件夹，在profile下新增一个main_pages.json文件，并配置如下内容。

   // MyApplication\library\src\main\resources\base\profile\main_pages.json
   {
     "src": [
       "pages/PageIndex"
     ]
   }
   

4. 在ets目录下新增pages目录，并在pages目录下新增PageIndex.ets文件，并配置如下内容。

   // MyApplication\library\src\main\ets\pages\PageIndex.ets
   @Entry
   @Component
   struct PageIndex {
     @State message: string = 'hello world';
   
     build() {
       Row() {
         Column() {
           Text(this.message)
             .fontSize(50)
             .fontWeight(FontWeight.Bold)
         }
         .width('100%')
       }
       .height('100%')
     }
   }
   

5. 删除HAR模块的build-profile.json5文件中的consumerFiles字段配置。

6. 修改HAR模块的hvigorfile.ts文件，将下面内容替换该文件内容。

   // MyApplication\library\hvigorfile.ts
   import { hspTasks } from '@ohos/hvigor-ohos-plugin';
   
   export default {
     system: hspTasks,  /* Built-in plugin of Hvigor. It cannot be modified. */
     plugins:[]         /* Custom plugin to extend the functionality of Hvigor. */
   }
   

7. 修改oh-package.json5文件，新增packageType配置。

   // MyApplication\library\oh-package.json5
   {
     "packageType": "InterfaceHar"
   }
   

8. 修改项目根目录下的配置文件build-profile.json5，在modules标签下找到library的配置，新增targets标签。

   // MyApplication\build-profile.json5
   "modules": [
     {
       "name": "library",
       "srcPath": "./library",
       "targets": [
         {
           "name": "default",
           "applyToProducts": [
             "default"
           ]
         }
       ]
     }
   ]