6.5 CdifUtil.deviceLog

方法说明

创建一条系统日志

方法原型

CdifUtil.deviceLog(deviceObj, logEntry);

返回类型

方法描述

CdifUtil.deviceLog用于为当前应用创建一条应用日志。每次条用会创建一条新的应用日志。该日志可在CEAMS系统中展现于当前应用的日志条目中。

CEAMS系统可为每个应用提供最近的1000条应用日志。更多的日志信息将被丢弃。

deviceObj为当前应用的对象引用。用户可在Device对象中通过this指针获取该引用。在系统为应用自动创建的应用框架代码中,每个API的实现代码默认已通过bind绑定到Device对象,可以在API实现代码中直接使用this来获取deviceObj对象引用。

logEntry为JSON对象、数组、字符串或number类型。内容为需要记录的日志条目。

在调试模式下,系统不会创建应用日志,而是将该日志的内容输出到调试窗口中。

代码范例

以下代码创建一条应用日志:

CdifUtil.deviceLog(this, ‘this is a test log’);

在以上代码执行后,用户可以在CEAMS系统“应用管理”页面中找到执行该代码的应用,并且点击其右侧的“应用日志”连接,如下图所示:

CdifUtil.deviceLog

在调试模式下,系统不会创建应用日志,而是将该日志的内容输出到调试窗口中。

在应用日志页面中,用户可以查看应用最近产生的1000条应用日志,以时间顺序倒序排列,最近的日志显示在最上方:

CdifUtil.deviceLog

错误信息

同步/异步

同步操作。