• 在引擎内添加 Log 信息
    • Log 信息机制和背景
    • EngineErrorMap 的编写规范
    • EngineErrorMap 的维护

    在引擎内添加 Log 信息

    本文档主要说明如何按照正确的规范在引擎内部代码中添加新的 Log 信息（包含 log, warning, error）。

    Log 信息机制和背景

    目前 Cocos Creator 中的 Log 信息是以一个错误信息表形式独立于引擎存储的，具体存储在 engine 目录下的 EngineErrorMap.md 中。而在引擎代码中，不允许直接以字符串形式写日志、警告、错误等信息，必须以下面三个 API 来书写：

    1. import { logID, warnID, errorID } from 'core/platform/debug';
    3. logID(id, ...params);
    4. warnID(id, ...params);
    5. errorID(id, ...params);

    这样做的主要目的是减少字符串在引擎源码中所占据的包体。

    EngineErrorMap 的编写规范

    EngineErrorMap 按照一百位来做大模块划分，总共四位，从 0000 到 9900，也就是说支持最多 100 个大模块。十位数是用来划分子模块的，或者也可以直接以连续的形式排列，这个由模块负责人决定。

    由于历史原因，目前没有按照严格的优先级顺序来做排序，新建的模块可以简单得往后顺延。未来我们会做更好的排序管理和整理。

    具体错误信息的编写规范如下：

    1. ### 4 number ID
    3. Message in english.

    比如

    1. ### 8300
    3. Should only one camera exists, please check your project.

    信息中支持使用 %s，%d，%f 这样的参数接收符，运行输出 LOG 时会按照参数顺序依次拼接到信息中。

    EngineErrorMap 的维护

    EngineErrorMap 修改后，如果希望代码中的调用生效，需要在 engine 目录下执行 

    1. > gulp build-debug-infos

    EngineErrorMap.md 的修改也要跟随引擎的其他修改提交到 git。