方法说明

创建一条系统日志

方法原型

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系统“应用管理”页面中找到执行该代码的应用，并且点击其右侧的“应用日志”连接，如下图所示：

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

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

错误信息

无

同步/异步

同步操作。