1# Ability助手使用指导 2 3Ability assistant（Ability助手，简称为aa）是实现应用、原子化服务、及测试用例启动功能的工具，为开发者提供基本的应用调试和测试的能力。通过该工具，开发者可以在hdc shell中，发送命令以执行各种系统操作，比如启动Ability、强制停止进程、打印Ability相关信息等。 4 5## 查询相关 6 7- **help** 8 9 用于显示aa相关的帮助信息。 10 11 **返回值：** 12 13 返回对应的帮助信息。 14 15 **使用方法：** 16 17 ``` 18 aa help 19 ``` 20 21## Ability相关 22 23- **start** 24 25 用于启动一个ability。 26 27 | 参数 | 参数说明 | 28 | --------- | -------------------------- | 29 | -h/--help | 帮助信息。 | 30 | -d | 可选参数，`device id`。 | 31 | -a | 必选参数，`ability name`。 | 32 | -b | 必选参数，`bundle name`。 | 33 | -D | 可选参数，调试模式。 | 34 35 **返回值：** 36 37 当成功启动Ability时，返回“start ability successfully.”；当启动失败时，返回“error: failed to start ability.”。 38 39 **使用方法：** 40 41 ``` 42 aa start [-d <device-id>] -a <ability-name> -b <bundle-name> [-D] 43 ``` 44 45- **stop-service** 46 47 用于停止Service Ability。 48 49 | 参数 | 参数说明 | 50 | --------- | ------------------------ | 51 | -h/--help | 帮助信息。 | 52 | -d | 可选参数，device id。 | 53 | -a | 必选参数，ability name。 | 54 | -b | 必选参数，bundle name。 | 55 56 **返回值：** 57 58 当成功停止Service Ability时，返回“stop service ability successfully.”；当停止失败时，返回“error: failed to stop service ability.”。 59 60 **使用方法：** 61 62 ``` 63 aa stop-service [-d <device-id>] -a <ability-name> -b <bundle-name> 64 ``` 65 66- **dump** 67 68 用于打印Ability的相关信息。 69 70 | 参数 | 二级参数 | 参数说明 | 71 | ----------------- | -------------------- | ------------------------------------------------------------ | 72 | -h/--help | - | 帮助信息。 | 73 | -a/--all | - | 打印所有mission内的Ability。 | 74 | -l/--mission-list | type（缺省打印全部） | 打印任务栈信息。<br />type：<br />NORMAL <br />DEFAULT_STANDARD<br />DEFAULT_SINGLE<br />LAUNCHER | 75 | -e/--extension | elementName | 打印扩展组件信息。 | 76 | -u/--userId | UserId | 打印指定UserId的栈信息，需要和其他参数组合使用，例如 `aa dump -a -u 100`、`aa dump -d -u 100` | 77 | -d/--data | - | 打印Data Ability。 | 78 | -i/--ability | AbilityRecord ID | 打印指定Ability详细信息。 | 79 | -c/--client | - | 打印Ability详细信息，需要和其他参数组合使用，例如 `aa dump -a -c`、`aa dump -i 21 -c` | 80 81 **使用方法：** 82 83 ``` 84 aa dump -a 85 ``` 86  87 ``` 88 aa dump -l 89 ``` 90  91 ``` 92 aa dump -i 12 93 ``` 94  95- **force-stop** 96 97 通过bundle name强制停止一个进程。 98 99 **返回值：** 100 101 当成功强制停止该进程时，返回“force stop process successfully.”；当强制停止失败时，返回“error: failed to force stop process.”。 102 103 **使用方法：** 104 105 ``` 106 aa force-stop <bundle-name> 107 ```
