harmony(鸿蒙)Ability助手使用指导

  • 2022-08-09
  • 浏览 (1201)

Ability助手使用指导

Ability assistant(Ability助手,简称为aa)是实现应用、原子化服务、及测试用例启动功能的工具,为开发者提供基本的应用调试和测试的能力。通过该工具,开发者可以在hdc shell中,发送命令以执行各种系统操作,比如启动Ability、强制停止进程、打印Ability相关信息等。

查询相关

  • help

用于显示aa相关的帮助信息。

返回值:

返回对应的帮助信息。

使用方法:

  aa help

Ability相关

  • start

用于启动一个ability。

参数 参数说明
-h/–help 帮助信息。
-d 可选参数,device id
-a 必选参数,ability name
-b 必选参数,bundle name
-D 可选参数,调试模式。

返回值:

当成功启动Ability时,返回“start ability successfully.”;当启动失败时,返回“error: failed to start ability.”。

使用方法:

  aa start [-d <device-id>] -a <ability-name> -b <bundle-name> [-D]
  • stop-service

用于停止Service Ability。

参数 参数说明
-h/–help 帮助信息。
-d 可选参数,device id。
-a 必选参数,ability name。
-b 必选参数,bundle name。

返回值:

当成功停止Service Ability时,返回“stop service ability successfully.”;当停止失败时,返回“error: failed to stop service ability.”。

使用方法:

  aa stop-service [-d <device-id>] -a <ability-name> -b <bundle-name>
  • dump

用于打印Ability的相关信息。

参数 二级参数 参数说明
-h/–help - 帮助信息。
-a/–all - 打印所有mission内的Ability。
-l/–mission-list type(缺省打印全部) 打印任务栈信息。
type:
NORMAL
DEFAULT_STANDARD
DEFAULT_SINGLE
LAUNCHER
-e/–extension elementName 打印扩展组件信息。
-u/–userId UserId 打印指定UserId的栈信息,需要和其他参数组合使用,例如 aa dump -a -u 100aa dump -d -u 100
-d/–data - 打印Data Ability。
-i/–ability AbilityRecord ID 打印指定Ability详细信息。
-c/–client - 打印Ability详细信息,需要和其他参数组合使用,例如 aa dump -a -caa dump -i 21 -c

使用方法:

  aa dump -a

aa-dump-a

  aa dump -l

aa-dump-l

  aa dump -i 12

aa-dump-i - force-stop

通过bundle name强制停止一个进程。

返回值:

当成功强制停止该进程时,返回“force stop process successfully.”;当强制停止失败时,返回“error: failed to force stop process.”。

使用方法:

  aa force-stop <bundle-name>

你可能感兴趣的鸿蒙文章

harmony(鸿蒙)Ability开发

harmony(鸿蒙)Ability框架概述

harmony(鸿蒙)测试框架使用指导

harmony(鸿蒙)应用上下文Context使用指导

harmony(鸿蒙)ContinuationManager开发指导

harmony(鸿蒙)FA模型综述

harmony(鸿蒙)DataAbility开发指导

harmony(鸿蒙)FA卡片开发指导

harmony(鸿蒙)PageAbility开发指导

harmony(鸿蒙)ServiceAbility开发指导

0  赞