【cocos2d-js官方文档】十九、Cocos2d-JS单文件引擎使用指引

浏览数：20 / 时间：2015年06月09日

这篇指引主要介绍如何使用从在线下载工具下载下来的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的另一种传统工作流，那种工作流中由引擎脚本控制脚本的加载顺序，所以不需要检测页面的加载。

你需要将这些文件放到一个本地服务器或在线服务器并通过服务器访问才可以看到正确的结果。