Notes 中文说明文档 - SmallAiTT/cocos-utils GitHub Wiki

当你有新增、删除资源文件，或者对资源重命名，或者改动资源文件路径的时候，切记执行cocos genRes命令。

当你有新增、删除js文件，或者对js重命名，或者改动js文件路径的时候，切记执行cocos genJsRes命令。

当你安装/移除了引擎模块(cocos.json中的dependencies)或者第三方模块(package.json中的dependencies)的时候，切记执行cocos genBaseCfg命令。

其实你可以只执行cocos build这个命令就可以了，因为改命令包括了以上的3个命令。

确保res.js以及jsRes.js中生成的key是唯一的，key的生成规则如下：

a.png  :  a_png        //"." 会被替换成 "_"
a-b.png  :  a_b_png    //"-" 会被替换成 "_"
1a.png  :  _1a_png     //如果第一个字母是数字，则会在前面添加"_"
a b.png  :  ab.png     //" " 会被替换成 ""

发布的时候cc.js将会被cc4publish.js替代，因为cc.js大多都是散文件加载相关以及测试相关的代码，没有必要发布。

在npm分支中，我们对测试用例进行了改造，跟develop分支差别很大。几乎所有的模块中都有测试用例，我们将原来的测试例重构了下，让测试例变得更加干净简洁，意在让开发者能够更加直观的查看引擎api的使用方式，降低开发者的学习成本。 记得将引擎的所有模块放在同一目录下，启动你的web服务器，你就可以访问各个模块的测试用例了（每个模块中的index.html）。