目录

构建HSP模块时报错“Ohos BundleTool [Error]: hsp has home ability;Ohos BundleTool [Error]: CompressEntrance::main exit, verify failed.”

问题现象

构建HSP模块时出现以下错误:Ohos BundleTool [Error]: hsp 包含 home 能力;Ohos BundleTool [Error]: CompressEntrance::main 校验失败。

问题原因

  1. 从DevEco Studio 5.0.2 Beta1版本开始,HSP支持配置UIAbility组件,除入口Ability外。
  2. 构建过程中,HSP模块会将依赖的HAR中的Ability与其自身配置合并。因此,HSP不支持依赖带有入口Ability的HAR。

解决措施

  1. 排查当前构建的HSP模块的module.json5,删除入口Ability中多余的skills配置,然后重新构建。
  2. 排查HSP模块依赖的HAR模块的module.json5文件。如果入口Ability配置了HAR,则:
    1. 若为本地源码依赖,删除上述配置后重新构建,或移除HSP中对该模块的依赖。
    2. 若为第三方包依赖,需删除对应配置并重新发布,更新依赖版本后重新构建。
    3. 如果第三方包依赖无法重新发布,可以通过Hvigor自定义插件在HSP模块中增加自定义任务,删除build/${productName}/intermediates/package/${targetName}/module.json中的入口 Ability 相关配置,然后重新构建。
      // HSP module hvigorfile.ts
      import { hspTasks,OhosPluginId, Target } from '@ohos/hvigor-ohos-plugin';
      import { hvigor, HvigorNode, HvigorPlugin,FileUtil } from '@ohos/hvigor';
      export function customPlugin():HvigorPlugin {
          return {
              pluginId: 'customPlugin',
              context() {
                  return {
                      data: 'customPlugin xxx'
                  };
              },
              apply(currentNode:HvigorNode): Promise<void> {
                  hvigor.nodesEvaluated(async () => {
                      hspTask(currentNode);
                  });
              }
          }
      }
      function hspTask(currentNode: HvigorNode) {
          // Obtain contextual information of the HSP module
          const hspContext = currentNode.getContext(OhosPluginId.OHOS_HSP_PLUGIN) as OhosHspContext;
          hspContext?.targets((target: Target) => {
              const targetName = target.getTargetName();
              const outputPath = target.getBuildTargetOutputPath();
              const task = currentNode.getTaskByName(`${targetName}@GeneratePkgModuleJson`);
              currentNode.registerTask({
                  // TASK
                  name: `${targetName}@changeModuleJson`,
                  // Task execution logic entity function
                  run() {
                      const moduleJson = FileUtil.readJson5(outputPath+"/../../intermediates/package/"+targetName+"/module.json");
                      const abilities = moduleJson['module']['abilities'];
                      abilities.forEach((ability)=>{
                          delete ability['skills'];
                      })
                      console.log('begin to rewrite module.json file.');
                      moduleJson['module']['abilities'] = abilities
                      FileUtil.writeFileSync(outputPath+"/../../intermediates/package/"+targetName+"/module.json",JSON.stringify(moduleJson));
                  },
                  // Configure prerequisite task dependencies
                  dependencies: [`${targetName}@GeneratePkgModuleJson`],
                  // Post task dependencies for configuring tasks
                  postDependencies: [`${targetName}@PackageSharedHar`]
              });
          });
      }
      export default {
          system: hspTasks,  /* Built-in plugin of Hvigor. It cannot be modified. */
          plugins:[customPlugin()]         /* Custom plugin to extend the functionality of Hvigor. */
      }