目录

HarmonyOS按需加载实现方法和常见问题

问题现象

如何通过按需加载能力减少首次安装时耗时和应用的占用空间?

背景知识

按需加载模块:用户首次从应用市场安装时,只会下载不包含按需加载模块的内容。当用户需要使用特定功能时,可以选择下载并安装相应的功能模块。

按需加载模块有以下好处:

解决方案

按需加载实现可分为三个步骤:基础包与扩展功能包分包、按需加载下载安装扩展功能包、运行扩展功能包。

步骤一:基础包与扩展功能包分包。

如果某个特性做成了按需加载模块,该模块可以设计为Feature类型的HAP或者HSP,HAP和HSP都可以实现按需加载,区别在于Feature类型的HAP可以包含UIAbility组件。

参考应用程序包开发与使用,将APP分为基础功能Entry包和按需加载的动态模块(Feature类型的HAP或者HSP)。

在动态模块的module.json5中设置deliveryWithInstall为false,来标识当前模块在用户主动安装应用的时候不会一起下载安装。

当动态模块为HSP时,基础功能Entry包的oh-package.json5中需要添加依赖项。添加HSP模块的动态依赖方式可参考如何配置oh-package.json5动态依赖。

步骤二:按需加载下载安装扩展功能包。

调用moduleInstallManager (产品特性按需分发)实现动态模块的按需加载,可分为以下几步:

  1. 使用getInstalledModule查询module是否安装。
  2. 通过createModuleInstallRequest创建按需加载请求对象。
  3. fetchModules按需加载请求下载module功能包。

步骤三:运行扩展功能包。

常见FAQ

Q:按需加载接入调试功能,如何在沙箱中导入动态模块。

A:Device File Browser可访问的文件夹有五种类型:应用沙箱目录、一般暂存区目录、日志目录、设备公共目录、媒体库目录。

  1. 按下图点击切换Device File Browser沙箱视图。

  2. 在//data/app/el2/base/cache/moduleinstall/下添加对应的动态模块。

Q:应用未上架如何测试按需加载功能?

A:推荐使用邀请测试。

Q:预装场景下,如果deliveryWithInstall配置为true,代码中是否不能引入@kit.AppGalleryKit?

A:没有这个限制。预装场景下系统会识别需要安装的文件,按需加载特性可以正常使用。