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 发布公共事件。 28 29* 用法 30 31 ``` 32 cem publish [<options>] 33 ``` 34 35 参数如下表所示 36 37 | 参数 | 参数说明 | 38 | ------------ | ------------------------------------------ | 39 | -e/--event | 必选参数,发布事件名称 | 40 | -s/--sticky | 可选参数,发布粘性事件,默认发布非粘性事件 | 41 | -o/--ordered | 可选参数,发布有序事件,默认发布无序事件 | 42 | -c/--code | 可选参数,公共事件结果码 | 43 | -d/--data | 可选参数,公共事件携带数据 | 44 | -h/--help | 帮助信息 | 45 46* 示例: 47 48 ```bash 49 # 发布名称为testevent的公共事件 50 cem publish --event "testevent" 51 ``` 52 53 ![cem-publish-event](figures/cem-publish-event.png) 54 55 ```bash 56 # 发布名称为testevent的粘性有序公共事件,该事件的结果码为100,携带数据内容为“this is data” 57 cem publish -e "testevent" -s -o -c 100 -d "this is data" 58 ``` 59 60 ![cem-publish-all](figures/cem-publish-all.png) 61 62### dump 63 64* 介绍 65 66 打印公共事件相关信息。 67 68* 用法 69 70 ``` 71 cem dump [<options>] 72 ``` 73 74 参数如下表所示 75 76 | 参数 | 参数说明 | 77 | ---------- | -------------------------------------------- | 78 | -a/--all | 打印开机以来所有已发送的公共事件及其具体信息 | 79 | -e/--event | 查询特定名称事件的具体信息 | 80 | -h/--help | 帮助信息 | 81 82* 示例 83 84 ```bash 85 # 打印公共事件名称为testevent的具体信息 86 cem dump -e "testevent" 87 ``` 88 89 ![cem-dump-e](figures/cem-dump-e.png) 90