HarmonyOS鸿蒙Next中集成态hsp支持并行开发使用方法

HarmonyOS鸿蒙Next中集成态hsp支持并行开发使用方法

对于ToB企业，很多情况下并不会进行源码集成，而是使用产物集成，针对该场景，可以采用HSP方式和APP/HAP进行异步构建、异步集成的方案。

1. 打包集成态hsp。

   • a. 将工程级build-profile.json5的useNormalizedOHMUrl字段设置为true。

     "app": {
       "products": [
         {
           "name": "default",
           "signingConfig": "default",
           "compatibleSdkVersion": "5.0.0(12)",
           "runtimeOS": "HarmonyOS",
           "buildOption": {
             "strictMode": {
               "caseSensitiveCheck": true,
               "useNormalizedOHMUrl": true
             }
           }
         }
       ],
     }
     

   • b. 将hsp模块级build-profile.json5的integratedHsp字段设置为true。

     "buildOption": {
       "arkOptions": { 
         "integratedHsp": true
       }
     }
     

   • c. 将编译模式切换为release后，选中hsp模块的根目录，点击Build > Make Module ${libraryName}启动构建，build目录下生成har包和tgz包。

   • （1）har是该模块的接口类。

   • （2）hsp-default-unsigned.hsp是该模块的实现类。

   • （3）tgz中包含hsp.har和hsp-default-unsigned.hsp。

2. 使用hsp的接口类har。

   • a. 在需要使用hsp的工程中，将工程级build-profile.json5的useNormalizedOHMUrl字段配置为true。
   • b. 先引入hsp.har包到工程中，使用import { xxx } from "hsp"的方法引用对应的接口并使用。

   该场景下编译可以通过，但是由于没有对应的实现所以无法运行调试。

3. 使用hsp的tgz包。 当并行开发到一定阶段可以拿到伙伴提供的tgz包，将之前依赖的hsp.har替换为hsp.tgz后即可使用hap模块的全部功能。

注意：hsp需要对外暴露的接口都需要在hsp中进行封装，否则使用hsp.har接口类的时候编译会报错。