1 2# 多HAP 3 4### 介绍 5 6本示例展示多HAP开发，简单介绍了多HAP的使用场景，应用包含了一个entry HAP和两个feature HAP，两个feature HAP分别提供了音频和视频播放组件，entry中使用了音频和视频播放组件。 三个模块需要安装三个hap包，最终会在设备上安装一个主entry的hap包。 7 8本示例用到了应用上下文Context接口 [@ohos.app.ability.common](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-common.md) 9媒体服务接口[@ohos.multimedia.media](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md) 10 11 12### 效果预览 13|主页|音频HAP|视频HAP| 14|---|---|---| 15|||| 16 17使用说明： 18 191.第一步：选择entry模块，运行生成entry模块的hap包 20 212.第二步：安装audioFeature和videoFeature的hap包：打开cmd执行hdc install hdc-path。例如audioFeature模块中hdc-path为：绝对路径/audioFeature/build/default/outputs/default/entry/audioFeature-entry-default-signed.hap 22 233.第三步：安装完三个模块hap包后重新运行entry模块 24 254.第四步：安装应用，点击桌面MultiHap图标，进入应用：点击audio，进入audio播放页面，点击PlayAudio按钮，播放音频 26 275.第五步：点击video，进入video播放页面，可点击播放按钮播放视频 28 29注意：多Hap应用的安装不能经过ide，需要手动执行一下命令 30``` 31hdc uninstall com.samples.multihap 32hdc install -r ".\audioFeature\build\default\outputs\default\audioFeature-entry-default-signed.hap" 33hdc install -r ".\videoFeature\build\default\outputs\default\videoFeature-entry-default-signed.hap" 34hdc install .\entry\build\default\outputs\default\entry-default-signed.hap 35hdc install .\entry\build\default\outputs\ohosTest\entry-ohosTest-signed.hap 36hdc shell aa test -b com.samples.multihap -m entry_test -s unittest OpenHarmonyTestRunner -s class ActsAbilityTest -s timeout 100000 37``` 38 39### 工程目录 40 41``` 42audioFeature/ 43| |--- src/main/ 44| |--- module.json5 // audio模块配置hap类型："type": "feature" 45| |---ets/pages 46| |---index.ets // audio组件的实现页面 47entry/src/ 48| |--- main/ 49| |--- module.json5 // entry模块配置hap类型："type": "entry" 50| |---ets/pages 51| |---index.ets // entry主应用入口，内含首页组件以及发起hap跳转逻辑 52videoFeature/ 53| |--- src/main/ 54| |--- module.json5 // video模块配置hap类型："type": "feature" 55| |---ets/pages 56| |---index.ets // video组件的实现页面 57``` 58 59 60 61#### 相关概念 62 63entry：应用的主模块，一个应用中，只有一个entry类型的HAP，一般实现应用的入口界面、入口图标、主特性功能等 64 65feature：应用的特性模块，一个应用中可以包含一个或者多个feature类型的HAP，也可以不含 66 67多HAP：一个应用工程中存在一个entry HAP和多个feature HAP 68 69### 具体实现 70 71* 新创建两个Module作为将被跳转的hap，分别命名为videoFeature，audioFeature。源码参考[Index.ets](entry/src/main/ets/pages/Index.ets) 72 * 配置每个hap的type：把entry文件夹下的module.json5中"type": "entry",videoFeature和audioFeature文件夹下的module.json5中"type": "feature"； 73 * 使用Want跳转到其他的Ability：在entry模块的index.ets中通过common.UIAbilityContext()配置Want，作为多hap间信息传递的载体，用于应用组件间的信息传递； 74 * want的配置：通过指定bundleName和abilityName可以唯一确定一个Ability。 75 * 新hap的跳转：在entry模块index.ets首页中，在按钮.onclick()事件内，通过Want配置显式拉起一个新的指定的Ability。 76 * 例如：以配置videoFeature模块Want配置为例，在触发按钮事件中加入配置的Want： 77 * btn.onClick(() => {this.context.startAbility({ 78 bundleName: BUNDLE_NAME, 79 abilityName: AUDIO_ABILITY_NAME 80 }} 81 * 其中bundleName为appscope文件夹下app.json5中"bundleName": "com.samples.multihap"。 82 * abilityName为videoFeature模块src/main/module.json5中abilities：["name": "VideoAbility"], 83 84 85### 相关权限 86 87不涉及。 88 89### 依赖 90 91不涉及。 92 93### 约束与限制 94 951.本示例仅支持在标准系统上运行。 96 972.本示例已适配API version 9版本SDK，版本号：3.2.11.9； 98 993.本示例需要使用DevEco Studio 3.1 Beta2 (Build Version: 3.1.0.400, built on April 7, 2023)及以上版本才可编译运行。 100 101### 下载 102 103如需单独下载本工程，执行如下命令： 104``` 105 106git init 107git config core.sparsecheckout true 108echo code/Project/ApplicationHap/MultiHap/ > .git/info/sparse-checkout 109git remote add origin https://gitee.com/openharmony/applications_app_samples.git 110git pull origin master 111 112``` 113 114
