這篇指引主要介紹如何使用從在線下載工具下載下來的Cocos2d-JS的單文件引擎。
你有可能下載了下面三個版本中的一個:
-
Cocos2d-JS Full Version: 完整版引擎包含Cocos2d-JS引擎的所有功能特性以及所有擴展,使用這個版本可以幫助你發掘Cocos2d-JS令人驚豔的創造力和可能性。你可以從官方文檔首頁中查看Cocos2d-JS所支持的特性列表。
-
Cocos2d-JS Lite Version: 精簡版本只包含Cocos2d-JS的核心特性,它的優勢是穩定,輕量,簡單易用。它所包含的特性列表如下:
- Canvas渲染器 (不支持WebGL)
- 場景和圖層
- 事件管理器
- 計時器
- 精靈和貼圖
- TTF文本
- 聲音
- 動作
- 菜單和菜單項
-
Customized Version: 如果你選擇了定製版本的引擎,引擎腳本文件將包含你所選擇的所有特性。
使用方式
單文件引擎的使用方式和其他Web庫完全一樣,你只需要將腳本嵌入到你的頁面中即可,可以參考下載目錄中的HelloWorld.html。
請注意腳本的加載時機,在HelloWorld的示例代碼中:
window.onload = function(){
cc.game.onStart = function(){
//...
};
cc.game.run("gameCanvas");
};
可以看到,cc.game.onStart
和cc.game.run
都在window的onload函數中,因爲只有在這時才能保證cocos2d-js-v3.0.js已經被加載成功,並且可以在你的用戶腳本中使用Cocos2d-JS的API。在我們後面章節中將提到Cocos2d-JS的另一種傳統工作流,那種工作流中由引擎腳本控制腳本的加載順序,所以不需要檢測頁面的加載。
你需要將這些文件放到一個本地服務器或在線服務器並通過服務器訪問纔可以看到正確的結果。
幫助鏈接
關於腳本壓縮
你可以使用Google Closure Compiler來將所有js文件壓縮成一個文件,Closure Compiler的高級壓縮壓縮比非常高,即便你下載的是壓縮版引擎,也可以獲得可觀的壓縮比。具體壓縮步驟如下:
- 下載Closure Compiler的jar程序文件
- 按照自己的環境配置build.xml
- 在控制檯運行ant命令
- 將頁面中的所有js引用刪除,引入打包出的
game.min.js
請注意,你不可以在html頁面中寫任何js腳本,所有js腳本都必須一起打包起來,否則會引起錯誤。
注意
當你通過服務器訪問遊戲頁面的時候,你將在控制檯中發現一個錯誤提示: "Failed to load resource: the server responded with a status of 404 (Not Found)",提示project.json
文件找不到
這是正常現象,並不是問題,你可以忽略它。或者可以添加一個空的project.json
文件來避免這個錯誤報告。