1# cem工具 2 3Common Event Manager（公共事件管理工具， 简称cem）是实现公共事件信息打印、发布公共事件等功能的工具，为开发者提供基本的公共事件调试和测试能力，例如打印所有公共事件订阅者、已发送公共事件和接受者、模拟发布公共事件等。 4 5> **说明：** 6> 7> 在使用本工具前，开发者需要先获取[hdc工具](../../device-dev/subsystems/subsys-toolchain-hdc-guide.md)，执行hdc shell。 8 9## cem调试助手 10 11### help 12 13* 介绍 14 15 打印帮助信息。 16 17* 用法 18 19 ``` 20 cem help 21 ``` 22 23### publish 24 25> **说明：** 26> 27> 当前工具区分eng与user版本。publish命令仅支持在eng版本中使用，在user版本中使用会出现报错error: user version cannot publish common events。 28 29* 介绍 30 31 发布公共事件。 32 33* 用法 34 35 ``` 36 cem publish [<options>] 37 ``` 38 39 参数如下表所示 40 41 | 参数 | 参数说明 | 42 | ------------ | ------------------------------------------ | 43 | -e/--event | 必选参数，发布事件名称 | 44 | -s/--sticky | 可选参数，发布粘性事件，默认发布非粘性事件 | 45 | -o/--ordered | 可选参数，发布有序事件，默认发布无序事件 | 46 | -c/--code | 可选参数，公共事件结果码 | 47 | -d/--data | 可选参数，公共事件携带数据 | 48 | -h/--help | 帮助信息 | 49 50* 示例： 51 52 ```bash 53 # 发布名称为testevent的公共事件 54 cem publish --event "testevent" 55 ``` 56 57  58 59 ```bash 60 # 发布名称为testevent的粘性有序公共事件，该事件的结果码为100，携带数据内容为“this is data” 61 cem publish -e "testevent" -s -o -c 100 -d "this is data" 62 ``` 63 64  65 66### dump 67 68* 介绍 69 70 打印公共事件相关信息。 71 72* 用法 73 74 ``` 75 cem dump [<options>] 76 ``` 77 78 参数如下表所示 79 80 | 参数 | 参数说明 | 81 | ---------- | -------------------------------------------- | 82 | -a/--all | 打印开机以来所有已发送的公共事件及其具体信息 | 83 | -e/--event | 查询特定名称事件的具体信息 | 84 | -h/--help | 帮助信息 | 85 86* 示例 87 88 ```bash 89 # 打印公共事件名称为testevent的具体信息 90 cem dump -e "testevent" 91 ``` 92 93  94
