From 11c44d2bade240d81b813ece7825c89a7b8631c5 Mon Sep 17 00:00:00 2001 From: unknown Date: Mon, 26 May 2025 14:53:26 +0800 Subject: [PATCH 1/2] add send-memory-level --- zh-cn/application-dev/tools/aa-tool.md | 69 ++++++++++++++++++++++++++ 1 file changed, 69 insertions(+) diff --git a/zh-cn/application-dev/tools/aa-tool.md b/zh-cn/application-dev/tools/aa-tool.md index 643ed61ccfc..2231d46c3ef 100644 --- a/zh-cn/application-dev/tools/aa-tool.md +++ b/zh-cn/application-dev/tools/aa-tool.md @@ -512,6 +512,39 @@ aa process -b -a [-m ] [-p ] [- aa process -b com.example.myapplication -a EntryAbility -p perf-cmd [-S] ``` +## onMemoryLevel回调命令（send-memory-level） + +从API version 20开始，开发者可以通过该命令来调试应用的[onMemoryLevel](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonmemorylevel)生命周期。通过在参数中指定进程的pid和内存使用级别来触发该进程的onMemoryLevel生命周期回调。 + +```bash +# 触发onMemoryLevel回调 +aa send-memory-level -p -l +``` + +**参数列表** + +| 参数 | 参数说明 | +| -------- | -------- | +| -h/--help | 帮助信息。 | +| -p | 必选参数，进程pid。 | +| -l | 必选参数，内存使用级别，具体值参考[AbilityConstant.MemoryLevel](../reference/apis-ability-kit/js-apis-app-ability-abilityConstant.md#memorylevel)。 | + +**返回值**： + +当执行成功时，返回"send memory level successfully."；当执行失败时，返回"error: failed to send memory level."；当给定参数值缺失时，返回"fail: unknow option."并打印帮助信息。 + +| 错误码ID | 错误信息 | +| ------- | -------- | +| 10104003 | The specified pid does not exist. | +| 10104004 | The specified level does not exist. | + +**示例**： + +```bash +# 触发进程号为6066应用的onMemoryLevel回调，此时回调的level为0 +aa send-memory-level -p 6066 -l 0 +``` + ## aa工具错误码 ### 10103001 目标Ability可见性校验失败 @@ -557,6 +590,42 @@ The specified ability does not exist. hdc shell bm dump -n 包名 ``` +### 10104003 指定的pid不存在 + +**错误信息** + +The specified pid does not exist. + +**错误描述** + +当指定的pid不存在时，aa工具将返回该错误码。 + +**可能原因** + +指定的pid不存在。 + +**处理步骤** + +检查-p参数指定的进程号在设备上是否存在。 + +### 10104004 指定的内存使用级别不存在 + +**错误信息** + +The specified level does not exist. + +**错误描述** + +当指定的内存使用级别不存在时，aa工具将返回该错误码。 + +**可能原因** + +指定的内存使用级别不存在。 + +**处理步骤** + +检查-l参数指定的内存使用级别是否为[0, 2]区间内的整数值。 + ### 10105001 Ability服务连接失败 **错误信息** -- Gitee From 5f89492ceebeed25dbd7bab43f9c75f44f419f38 Mon Sep 17 00:00:00 2001 From: lidongrui Date: Sat, 28 Jun 2025 06:44:21 +0000 Subject: [PATCH 2/2] update zh-cn/application-dev/tools/aa-tool.md. Signed-off-by: lidongrui --- zh-cn/application-dev/tools/aa-tool.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/zh-cn/application-dev/tools/aa-tool.md b/zh-cn/application-dev/tools/aa-tool.md index 2231d46c3ef..46f880e2bff 100644 --- a/zh-cn/application-dev/tools/aa-tool.md +++ b/zh-cn/application-dev/tools/aa-tool.md @@ -30,6 +30,7 @@ hdc shell "aa process -b com.example.myapplication -a EntryAbility -p perf-cmd" | detach | 退出调试模式命令。通过bundleName使指定应用退出调试模式。| | appdebug | 等待调试命令。用于设置、取消设置应用等待调试状态，以及获取处于等待调试状态的应用包名和持久化信息。等待调试状态只对debug类型应用生效。appdebug的设置命令只对单个应用生效，当重复设置时，应用包名与持久化状态会替换成最新设置内容。| | process | 应用调试/调优命令。对应用进行调试或调优，IDE用该命令集成调试和调优工具。| +| send-memory-level | onMemoryLevel回调命令。指定进程的pid和内存使用级别来触发该进程的onMemoryLevel生命周期回调。| ## 帮助命令（help） @@ -514,7 +515,7 @@ aa process -b -a [-m ] [-p ] [- ## onMemoryLevel回调命令（send-memory-level） -从API version 20开始，开发者可以通过该命令来调试应用的[onMemoryLevel](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonmemorylevel)生命周期。通过在参数中指定进程的pid和内存使用级别来触发该进程的onMemoryLevel生命周期回调。 +从API version 13开始，开发者可以通过该命令来调试应用的[onMemoryLevel](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonmemorylevel)生命周期。通过在参数中指定进程的pid和内存使用级别来触发该进程的onMemoryLevel生命周期回调。 ```bash # 触发onMemoryLevel回调 -- Gitee