概述
項目相關配置,由原來的cocos2d.js
中轉移到project.json
中,該文件需要與index.html
同級,一般建議放在根目錄下。
由原來的cocos2d.js
改爲project.json
的好處如下:
-
原來的
cocos2d.js
中參雜了一些邏輯代碼,無法很好體現其就是作爲項目的配置文件。 -
用json格式作爲配置文件會更友好。也可以使得
cocos-console
、cocos-utils
,甚至是用戶自定義腳本工具能夠使用同一個配置文件。
字段說明
debugMode
相當於原來的COCOS2D_DEBUG
,其中:
0表示關閉調試模式,1表示log,2表示warn,3表示error,5表示logForWebPage,6表示warnForWebPage,7表示errorForWebPage。
renderMode
跟原來配置相同,表示渲染模式。0爲默認,1爲canvas,2爲webgl。
showFPS
跟原來配置相同,表示是否開啓幀率顯示。默認爲false。
frameRate
跟原來配置相同,表示設置幀率。默認爲60。
engineDir
跟原來配置相同,用於指定引擎目錄。區別在於,在v2版本中,指向的是**/cocos2d-html5/cocos2d
,但在v3版本中,只要指向**/cocos2d-html5
就行了。
默認爲"frameworks/cocos2d-html5"。
jsList
相當於原來的appFiles
,用於羅列用於js列表。
id
相當於原來的tag
,用於指定canvas的id。
modules
用於指定加載模塊。
在v2版本中,只能通過loadExtension
、box2d
、chipmunk
、pluginx
等開關來指定是否使用某個模塊。
在v3版本中則使用modules
字段,靈活進行配置,這也能較好的支持今後引擎進行模塊裁剪。配置如下:
"modules" : ["extensions", "pluginx", "box2d", "chipmunk"]
如果想知道引擎中具體提供了哪些模塊,可以參見moduleConfig.json
文件中的module
字段。