鸿蒙中Stage应用，APP、HAP、HAR和HSP

android大哥
256 阅读6分钟

工程结构

  • AppScope中的app.json5 ,用于声明应用的全局配置信息，比如应用Bundle名称、应用名称、应用图标、应用版本号等。
  • module中的module.json5,用于声明Module基本信息、支持的设备类型、所含的组件信息、运行所需申请的权限等。
  • module 中src->main->ets 主要放源码 ets文件
  • AppScope > resources ：用于存放应用需要用到的资源文件。
  • Module_name > src > main > resources ：用于存放该Module需要用到的资源文件

APP

当应用发布上架到应用市场时，需要将Bundle打包为一个.app后缀的文件用于上架，这个.app文件称为App Pack（Application Package），与此同时，DevEco Studio工具自动会生成一个pack.info文件。pack.info文件描述了App Pack中每个HAP和HSP的属性，包含APP中的bundleName和versionCode信息、以及Module中的name、type和abilities等信息。 HAP、HAR、HSP三者的功能和使用场景总结对比如下：

Module类型包类型说明
AbilityHAP应用的功能模块，可以独立安装和运行，必须包含一个entry类型的HAP，可选包含一个或多个feature类型的HAP。
Static LibraryHAR静态共享包，编译态复用。- 支持应用内共享，也可以发布后供其他应用使用。- 作为二方库，发布到OHPM私仓，供公司内部其他应用使用。- 作为三方库，发布到OHPM中心仓，供其他应用使用。- 多包（HAP/HSP）引用相同的HAR时，会造成多包间代码和资源的重复拷贝，从而导致应用包膨大。- 注意：编译HAR时，建议开启混淆能力，保护代码资产。
Shared LibraryHSP动态共享包，运行时复用。- 当前仅支持应用内共享。- 当多包（HAP/HSP）同时引用同一个共享包时，采用HSP替代HAR，可以避免HAR造成的多包

二 HAP (Harmony Ability Package)

是应用安装和运行的基本单元。HAP包是由代码、资源、第三方库、配置文件等打包生成的模块包，其主要分为两种类型：entry和feature。创建module的时候是Ability

  • entry：应用的主模块，作为应用的入口，提供了应用的基础功能。
  • feature：应用的动态特性模块，作为应用能力的扩展，可以根据用户的需求和设备类型进行选择性安装。

HAP 规则

  • 不支持导出接口和ArkUI组件，给其他模块使用。
  • 多HAP场景下，App Pack包中同一设备类型的所有HAP中必须有且只有一个Entry类型的HAP，Feature类型的HAP可以有一个或者多个，也可以没有。
  • 多HAP场景下，同一应用中的所有HAP的配置文件中的bundleName、versionCode、versionName、minCompatibleVersionCode、debug、minAPIVersion、targetAPIVersion、apiReleaseType相同，同一设备类型的所有HAP对应的moduleName标签必须唯一。HAP打包生成App Pack包时，会对上述参数配置进行校验。
  • 多HAP场景下，同一应用的所有HAP、HSP的签名证书要保持一致。上架应用市场是以App Pack形式上架，应用市场分发时会将所有HAP从App Pack中拆分出来，同时对其中的所有HAP进行重签名，这样保证了所有HAP签名证书的一致性。在调试阶段，开发者通过命令行或DevEco Studio将HAP安装到设备上时，要保证所有HAP签名证书一致，否则会出现安装失败的问题。

HAR（Harmony Archive）

是静态共享包，可以包含代码、C++库、资源和配置文件。通过HAR可以实现多个模块或多个工程共享ArkUI组件、资源等相关代码。创建module的时候是Static Library ，比如网络库 日志库

HAR的规则

  • HAR不支持在设备上单独安装/运行，只能作为应用模块的依赖项被引用。
  • HAR不支持在配置文件中声明UIAbility组件与ExtensionAbility组件。
  • HAR不支持在配置文件中声明pages页面，但是可以包含pages页面，并通过命名路由的方式进行跳转。
  • HAR不支持引用AppScope目录中的资源。在编译构建时，AppScope中的内容不会打包到HAR中，因此会导致HAR资源引用失败。
  • HAR可以依赖其他HAR，但不支持循环依赖，也不支持依赖传递。

HAR的导出

Index.ets文件是HAR导出声明文件的入口，在模块的oh-package.json5文件中的main字段配置入口声明文件

Index.ets

// 导出组件
export { MainPage } from './src/main/ets/components/mainpage/MainPage';
// 导出类
export { Log } from './src/main/ts/test';
// 导出方法
export { func } from './src/main/ts/test';
export { func2 } from './src/main/ts/test';

HAR资源覆盖关系

在编译构建HAP时，DevEco Studio会从HAP模块及依赖的模块中收集资源文件，

  • AppScope
  • HAP包自身模块。
  • 依赖的HAR模块，如果依赖的多个HAR之间有资源冲突，会按照工程oh-package.json5中dependencies下的依赖顺序进行覆盖，依赖顺序在前的优先级较高

编译

建议开启混淆能力。 混淆能力开启后，DevEco Studio在构建HAR时，会对代码进行编译、混淆及压缩处理，保护代码资产

三 HSP

HSP（Harmony Shared Package）是动态共享包，可以包含代码、C++库、资源和配置文件，通过HSP可以实现代码和资源的共享。HSP不支持独立发布，而是跟随其宿主应用的APP包一起发布，与宿主应用同进程，具有相同的包名和生命周期。Shared Library

规则

  • HSP不支持在设备上单独安装/运行，需要与依赖该HSP的HAP一起安装/运行。HSP的版本号必须与HAP版本号一致。
  • HSP不支持在配置文件中声明UIAbility组件与ExtensionAbility组件。
  • HSP可以依赖其他HAR或HSP，但不支持循环依赖，也不支持依赖传递。
  • 集成态HSP只支持Stage模型。
  • 集成态HSP需要API12及以上版本，使用标准化的OHMUrl格式。

导出

方法和类 上HAR一样

导出资源

跨包访问HSP内资源时，推荐实现一个资源管理类，以封装对外导出的资源。采用这种方式，具有如下优点：

  • HSP开发者可以控制自己需要导出的资源，不需要对外暴露的资源可以不用导出。
  • 使用方无须感知HSP内部的资源名称。当HSP内部的资源名称发生变化时，也不需要使用方跟着修改。
avatar
文章
阅读
粉丝