【鸿蒙next教程】调试命令：anm工具

最新推荐文章于 2025-08-13 20:41:05 发布

原创最新推荐文章于 2025-08-13 20:41:05 发布 · 776 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #华为 #ArkTS #鸿蒙系统 #ArkUI #调试命令 #anm工具

鸿蒙5.0 同时被 3 个专栏收录

1442 篇文章

订阅专栏

ArkUI

1224 篇文章

订阅专栏

ArkTS

533 篇文章

订阅专栏

往期鸿蒙全套实战文章必看：（附带鸿蒙全栈学习资料）

anm工具

Advanced Notification Manager（通知管理工具，简称anm）是实现通知打印、设置通知参数等功能的工具，为开发者提供基本的通知调试和测试能力，例如打印已发布通知详细信息、设置通知缓存个数、使能通知等。

环境要求

在使用本工具前，开发者需要先获取hdc工具，执行hdc shell。

当前工具仅支持在eng版本中使用，在user版本中使用会出现报错error: user version cannot use setting。

anm工具命令列表

命令	描述
help	帮助命令，用于显示anm相关的帮助信息。
dump	打印命令，用于打印通知相关信息。
setting	设置命令，用于设置通知参数。

帮助命令（help）

# 显示anm相关的帮助信息
anm help

打印命令（dump）

# 打印通知相关信息
anm dump [<options>]

打印命令参数列表

参数	参数说明
-A/--active	打印所有活跃的通知信息。
-R/--recent	打印最近的通知信息。
-D/--distributed	打印来自其他设备的分布式通知信息。
-b/--bundle	可选参数，设置指定的Bundle名称打印。
-u/--user-id	可选参数，设置指定的用户ID打印。
-h/--help	帮助信息。

示例：

# 打印活跃的通知信息
anm dump -A

设置命令（setting）

# 设置通知参数
anm setting [<options>]

设置命令参数列表

参数	参数说明
-c/--recent-count	设置保存在内存中的最近通知的最大个数。
-e/--enable-notification	设置通知使能开关。
-k/--collaboration-switch	设置通知是否支持跨设备协同至指定类型设备。 anm setting -k <deviceType>:<status> 说明：从API version 18开始，新增支持该命令参数。 deviceType表示需要指定的设备类型。取值范围包括：wearable（智能穿戴设备）、litewearable（轻量级智能穿戴设备）、headset（可穿戴式音频设备）。 status表示需要指定的跨设备协同开关状态。取值为0表示开关为关闭状态，取值为1表示开关为打开状态。
-b/--collaboration-switch-bundle	设置指定应用的通知是否支持跨设备协同至指定类型设备。 anm setting -b <deviceType>:<bundleName>:<uid>:<status> 说明：从API version 18开始，新增支持该命令参数。 deviceType表示需要指定的设备类型。取值范围包括：wearable（智能穿戴设备）、litewearable（轻量级智能穿戴设备）、headset（可穿戴式音频设备）。 status表示需要指定的跨设备协同开关状态。取值为0表示开关为关闭状态，取值为1表示开关为打开状态。
-o/--collaboration-switch-slot	设置指定渠道的通知是否支持通知跨设备协同至指定类型设备。 anm setting -o <deviceType>:<slotType>:<status> 说明：从API version 18开始，新增支持该命令参数。 deviceType表示需要指定的设备类型。取值范围包括：wearable（智能穿戴设备）、litewearable（轻量级智能穿戴设备）、headset（可穿戴式音频设备）。 slotType表示需要指定的通知渠道类型。取值范围参考SlotType。 status表示需要指定的跨设备协同开关状态。取值为0表示开关为关闭状态，取值为1表示开关为打开状态。
-h/--help	帮助信息。

示例：

# 设置保存在内存中的最近通知的最大数为100个
anm setting -c 100


# 设置通知跨设备协同至wearable类型设备的开关为打开状态
anm setting -k wearable:1


# 设置包名为example，uid为10100的应用通知跨设备协同至litewearable类型设备的开关为关闭状态
anm setting -b litewearable:example:10100:0


# 设置渠道类型为0的通知跨设备协同至headset类型设备的开关为打开状态
anm setting -o headset:0:1