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