目录

元服务启动入口

Q:使用IDE调试元服务,可以正常打开,划掉元服务,找不到再次打开元服务的入口?

A:启动元服务可以通过服务卡片、负一屏以及hdc命令行三种方案:

背景知识:服务卡片是系统一种呈现信息和交互操作的载体,在应用或元服务中提取关键信息和核心操作,以卡片的形式展示在桌面上,用户通过与服务卡片交互即可实现服务直达,减少交互层级,提升用户体验,参见服务卡片开发;aa工具(Ability assistant,Ability助手)是用于启动应用和启动测试用例的工具,为开发者提供基本的应用调试和测试能力,参见aa工具。

为什么划掉元服务后桌面上找不到入口:元服务的图标不允许添加至桌面,它只能以服务卡片的形式加桌,或出现在负一屏的"最近""我的服务"中。因此划掉(从后台任务列表移除)后,桌面上没有可直接点击的图标,需通过以下任一方式重新进入。

方案一:服务卡片:

方案二:负一屏:

方案三:hdc命令:

验证是否安装成功:执行 hdc shell bm dump -a,若 {bundleName} 不在输出列表中,说明应用未安装成功。

Q:通过aa工具启动元服务/应用报错"error: failed to start ability. error: resolve ability err.",如何解决?

A:该报错表示 aa 工具未能解析出要启动的 Ability(对应错误码 10104001,The specified ability does not exist.)。按以下步骤排查:

  1. 检查当前设备上元服务/应用是否安装成功:执行 hdc shell bm dump -a,若 bundleName 不在输出列表中,说明未安装成功。
  2. 检查 aa 命令中的包名与 Ability 名是否正确:-b(bundleName)与 -a(abilityName)都要与目标应用一致,-a 不能固定写 EntryAbility。
  3. 多 HAP 应用,还需确认该 Ability 所属的 HAP 已安装:执行 hdc shell bm dump -n {bundleName},查看输出中是否包含对应模块与 Ability。
  4. 确认目标 Ability 在 module.json5 中的 exported 为 true,否则无法被 aa 命令拉起(对应错误码 10103001)。

Q:在终端使用hdc install xxxx.hap进行安装,安装结束后元服务应用不会自动打开,在负一屏的元服务板块也无法找到该安装包。怎么启动元服务?

A:在负一屏找不到该元服务,是因为未上架应用市场的元服务不会在负一屏展示(官方 FAQ:「元服务在未上架状态下不会在负一屏更新图标,将元服务上架后即可在负一屏更新。」)。本地调试阶段,可以用 aa 工具直接拉起元服务:

hdc shell aa start -a EntryAbility -b {bundleName}

其中 EntryAbility 与 {bundleName} 请替换为实际值。

Q:通过aa工具启动元服务/应用报错"[Fail]ExecuteCommand need connect-key? please confirm a device by help info"?

A:由于使用hdc命令时未正确指定目标设备导致的,可能连接多个设备未指定设备标识符或者设备连接异常,确保执行hdc list targets能够正常获取设备标识符(connect-key),如果有多个设备,需要在命令中通过-t参数指定目标设备标识符。

hdc -t {connect-key} shell aa start -a EntryAbility -b {bundleName}