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 100、aa dump -d -u 100
  -d/--data	-	打印Data Ability。
  -i/--ability	AbilityRecord ID	打印指定Ability详细信息。
  -c/--client	-	打印Ability详细信息，需要和其他参数组合使用，例如 aa dump -a -c、aa dump -i 21 -c

  使用方法：

  aa dump -a
  

  

  aa dump -l
  

  

  aa dump -i 12
  

  

• force-stop

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

  返回值：

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

  使用方法：

  aa force-stop <bundle-name>