鸿蒙HarmonyOS 5.0开发：典型场景开发-集成态HSP

 往期鸿蒙全套实战文章必看：（文中附带鸿蒙全栈学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

集成态HSP

集成态HSP是应用内HSP的一种中间编译产物，目的就是解决使用方的bundleName和签名之间的强耦合问题。

说明

HSP只能给bundleName一样的项目使用，集成态HSP可以给不同的bundleName的工程集成使用。

使用场景

集团内部有多个应用，多个应用中都有一个相同的动态共享包。为了节约开发成本，实现代码和资源的共享，多个应用可以共享一个基建HSP(集成态HSP)。

约束限制

• 集成态HSP只支持Stage模型。
• 集成态HSP需要API12及以上版本，需要在工程级的build-profile.json5文件中，将useNormalizedOHMUrl字段设置为true。

开发使用说明

1. 创建方-集成态HSP-工程配置：集成态HSP需要在工程级的build-profile.json5文件中，将useNormalizedOHMUrl字段设置为true。

   // created_party_project/build-profile.json5
   {
     "app": {
       "products": {
         "name": "default",
         "signingConfig": "default",
         "compatibleSdkVersion": "5.0.0(12)",
         "runtimeOS": "HarmonyOS",
         "buildOption": {
           "strictMode": {
             "useNormalizedOHMUrl": true
           }
         }
       }
     }
   }

2. 创建方-集成态HSP-模块配置：修改模块级构建配置文件build-profile.json5，设置配置项integratedHsp为true，指定构建的HSP模块为集成态HSP。

   // created_party_project/library/build-profile.json5
   {
     "apiType": "stageMode",
     "buildOption": {
       "arkOptions": {
         "integratedHsp": true
       }
     }
   }

3. 创建方-集成态HSP-打包配置（tgz包）。

   (1) 配置项目签名信息；

   (2) 配置release模式；

   

   (3) 选择library目录，Build -> Make Module 'libray'。

4. 使用方-创建目录拷贝文件，在entry目录下新建libs目录，将集成态打包产物tgz包拷贝到libs目录下。

5. 使用方-工程依赖配置：使用方主模块下oh-package.json5配置文件中添加依赖。

   // user_project/entry/oh-package.json5
     "dependencies": {
       "hsp": "./libs/library-default.tgz"
     }

6. 使用方-工程配置：集成态HSP需要在工程级的build-profile.json5文件中，将useNormalizedOHMUrl字段设置为true。

   // user_project/build-profile.json5
   {
     "app": {
       "products": {
         "name": "default",
         "signingConfig": "default",
         "compatibleSdkVersion": "5.0.0(12)",
         "runtimeOS": "HarmonyOS",
         "buildOption": {
           "strictMode": {
             "useNormalizedOHMUrl": true
           }
         }
       }
     }
   }

   说明

   安装运行应用前，使用方工程必须配置项目签名信息。