这篇指引主要介绍怎样使用从在线下载工具下载下来的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的还有一种传统工作流，那种工作流中由引擎脚本控制脚本的载入顺序。所以不须要检測页面的载入。

你须要将这些文件放到一个本地server或在线server并通过server訪问才干够看到正确的结果。

  • ​

关于脚本压缩

你能够使用Google Closure Compiler来将全部js文件压缩成一个文件。Closure Compiler的高级压缩压缩比很高，即便你下载的是压缩版引擎，也能够获得可观的压缩比。

详细压缩过程例如以下：

  2. 下载Closure Compiler的jar程序文件
  3. 依照自己的环境配置build.xml
  4. 在控制台执行ant命令
  5. 将页面中的全部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​​文件来避免这个错误报告。

​