多HAP
介绍
本示例展示多HAP开发，简单介绍了多HAP的使用场景，应用包含了一个entry HAP和两个feature HAP，两个feature HAP分别提供了音频和视频播放组件，entry中使用了音频和视频播放组件。 三个模块需要安装三个hap包，最终会在设备上安装一个主entry的hap包。
本示例用到了应用上下文Context接口 @ohos.app.ability.common
媒体服务接口@ohos.multimedia.media
效果预览
| 主页 | 音频HAP | 视频HAP |
|---|---|---|
 |
 |
 |
使用说明：
1.第一步：使用Deveco Studio打开工程，在Run->Edit Configurations->Applications中找到entry，在右侧选中Deploy Multi Hap，勾选Deploy Multi Hap Packages，并在下拉菜单拦中勾选audioFeature、videoFeature、entry，点击Apply
2.第二步：Run Configurations中选择entry，点击Run 'entry'，在设备上安装运行
3.第三步：点击桌面MultiHap图标，进入应用：点击audio，进入audio播放页面，点击PlayAudio按钮，播放音频
4.第四步：点击video，进入video播放页面，可点击播放按钮播放视频
工程目录
audioFeature/
| |--- src/main/
| |--- module.json5 // audio模块配置hap类型："type": "feature"
| |---ets/pages
| |---index.ets // audio组件的实现页面
entry/src/
| |--- main/
| |--- module.json5 // entry模块配置hap类型："type": "entry"
| |---ets/pages
| |---index.ets // entry主应用入口，内含首页组件以及发起hap跳转逻辑
videoFeature/
| |--- src/main/
| |--- module.json5 // video模块配置hap类型："type": "feature"
| |---ets/pages
| |---index.ets // video组件的实现页面
相关概念
entry：应用的主模块，一个应用中，只有一个entry类型的HAP，一般实现应用的入口界面、入口图标、主特性功能等
feature：应用的特性模块，一个应用中可以包含一个或者多个feature类型的HAP，也可以不含
多HAP：一个应用工程中存在一个entry HAP和多个feature HAP
具体实现
- 新创建两个Module作为将被跳转的hap，分别命名为videoFeature，audioFeature。源码参考Index.ets
- 配置每个hap的type：把entry文件夹下的module.json5中"type": "entry",videoFeature和audioFeature文件夹下的module.json5中"type": "feature"；
- 使用Want跳转到其他的Ability：在entry模块的index.ets中通过common.UIAbilityContext()配置Want，作为多hap间信息传递的载体，用于应用组件间的信息传递；
- want的配置：通过指定bundleName和abilityName可以唯一确定一个Ability。
- 新hap的跳转：在entry模块index.ets首页中，在按钮.onclick()事件内，通过Want配置显式拉起一个新的指定的Ability。
- 例如：以配置videoFeature模块Want配置为例，在触发按钮事件中加入配置的Want：
- btn.onClick(() => {this.context.startAbility({ bundleName: BUNDLE_NAME, abilityName: AUDIO_ABILITY_NAME }}
- 其中bundleName为appscope文件夹下app.json5中"bundleName": "com.samples.multihap"。
- abilityName为videoFeature模块src/main/module.json5中abilities：["name": "VideoAbility"],
相关权限
不涉及。
依赖
不涉及。
约束与限制
1.本示例仅支持在标准系统上运行。
2.本示例已适配API version 15 版本SDK
3.本示例需要使用DevEco Studio 5.0.3 Release (Build Version: 5.0.9.300, built on March 13, 2025)及以上版本才可编译运行。
下载
如需单独下载本工程，执行如下命令：
git init
git config core.sparsecheckout true
echo code/Project/ApplicationHap/MultiHap/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master