这篇指引主要介绍怎样使用从在线下载工具下载下来的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的高级压缩压缩比很高，即便你下载的是压缩版引擎，也能够获得可观的压缩比。
详细压缩过程例如以下：
- 下载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文件来避免这个错误报告。