[size=2]应广大同学的对文档的迫切需求,我们抢先 发布 2.1章节,给大家先感觉感觉 [s:870] 有什么意见可以跟帖回复哦。我们会继续改进嗒。[/size]
[size=2]使用手册 2.1章节 用Cocos2d-JS Lite Version开发网页游戏/微信游戏(浏览器开发环境介绍)[/size]
[size=2]Cocos2d-JS为纯Web开发者提供了特别定制的一套更友好的工作流,对于这些开发者来说,如果Cocos2d-JS可以像其他Web框架一样用单个文件被引入到用户页面中并可以直接使用的话,会更符合他们的开发习惯。而Cocos2d-JS引擎包看上去对于Web开发者来说实在是太庞大和复杂了,对于Web开发者来说,就好像被扔进了一个巨大的迷宫,完全不知道从哪下手。这甚至会给开发者一种错误的认知:"Cocos2d-JS是一个非常重的引擎,不适合做Web游戏开发。"[/size]
[size=2]实际上,在Cocos2d-JS的Web引擎实现模块化之后,可以非常优美得做到既强大又轻量。也正是以上原因,促使我们推出了Lite Version以及专为Lite Version定制的工作流供纯Web开发者使用。[/size]
[size=2]这一章节中,我们会介绍Cocos2d-JS Lite Version的工作流。[/size]
[size=4]下载Cocos2d-JS Lite Version[/size]
[size=2]请在[/size]下载页面[size=2]中下载最新版本的Lite Version引擎。[/size]
[size=2]除了Lite Version以外你还可以选择下载完整版引擎或定制一个自己专属的引擎版本。[/size]
[size=2]与此同时,选中压缩选项可以帮助你减小引擎脚本的大小,但是会导致引擎代码不可读,所以请在开发阶段选择未压缩版,发布阶段替换为压缩版。当然,你也可以同时下载压缩版与未压缩版,方便切换。[/size]
[size=3]下载内容[/size]
[size=2]为了让开发者更易于使用,下载页面中下载下来的将是一个完整的HelloWorld项目,包含以下内容:[/size]
[table=80%][tr][td][size=2] 文件名 [/size][/td][td][size=2]描述[/size][/td][/tr][tr][td][size=2]build.xml[/size][/td][td][size=2]Google Closure Compiler代码压缩工具所使用的ant build配置文件,你可以下载Closure Compiler,修改配置文件中的js文件列表,并使用ant来压缩所有代码以获得非常高的压缩比[/size][/td][/tr][tr][td][size=2]cocos2d-js-v3.0.js[/size][/td][td][size=2]这是Cocos2d-JS引擎的js文件,只需要将这个文件引入页面中,就可以使用Cocos2d-JS来开发游戏[/size][/td][/tr][tr][td][size=2]HelloWorld.html[/size][/td][td][size=2]HelloWorld工程的主页面,其中包含HelloWorld游戏代码[/size][/td][/tr][tr][td][size=2]HelloWorld.png[/size][/td][td][size=2]游戏所使用的图片文件[/size][/td][/tr][tr][td][size=2]README.md[/size][/td][td][size=2]Cocos2d-JS Lite Version使用指南[/size][/td][/tr][/table]
[size=4]使用指南[/size]
[size=2]你有可能下载了下面三个版本中的一个:[/size]
[size=2]Cocos2d-JS Full Version: 完整版引擎包含Cocos2d-JS引擎的所有功能特性以及所有扩展,使用这个版本可以帮助你发掘Cocos2d-JS令人惊艳的创造力和可能性。你可以从官方文档首页中查看Cocos2d-JS所支持的特性列表。[/size]
[size=2]Cocos2d-JS Lite Version: 精简版本只包含Cocos2d-JS的核心特性,它的优势是稳定,轻量,简单易用。它所包含的特性列表如下:[/size]
[list][li][size=2]Canvas渲染器 (不支持WebGL)[/size][/li][li][size=2]场景和图层[/size][/li][li][size=2]事件管理器[/size][/li][li][size=2]计时器[/size][/li][li][size=2]精灵和贴图[/size][/li][li][size=2]TTF文本[/size][/li][li][size=2]声音[/size][/li][li][size=2]动作[/size][/li][li][size=2]菜单和菜单项[/size][/li][/list]
[size=2]
[/size]
[size=2]
[/size]
[size=2]Customized Version: 如果你选择了定制版本的引擎,引擎脚本文件将包含你所选择的所有特性。[/size]
[size=4]使用方式[/size]
[size=2]单文件引擎的使用方式和其他Web库完全一样,你只需要将脚本嵌入到你的页面中即可,可以参考下载目录中的HelloWorld.html。[/size]
[size=2]请注意脚本的加载时机,在HelloWorld的示例代码中:[/size]
[size=2] [/size]window.onload = function(){
    cc.game.onStart = function(){
        //...
    };
    cc.game.run("gameCanvas");
};[size=2] [/size]
[size=2]可以看到,cc.game.onStart和cc.game.run都在window的onload函数中,因为只有在这时才能保证cocos2d-js-v3.0.js已经被加载成功,并且可以在你的用户脚本中使用Cocos2d-JS的API。在我们后面章节中将提到Cocos2d-JS的另一种传统工作流,那种工作流中由引擎脚本控制脚本的加载顺序,所以不需要检测页面的加载。[/size]
[size=2]另外,你需要将这些文件放到一个本地服务器或在线服务器并通过服务器访问才可以看到正确的结果。[/size]
[size=2]帮助链接[/size]
[size=2]在线API reference[/size]
[size=2]下载API Reference[/size]
[size=2]文档目录[/size]
[size=2]Github仓库[/size]
[size=2]在线论坛[/size]
[size=2]在线测试例[/size]
[size=4]关于脚本压缩[/size]
[size=2]你可以使用Google Closure Compiler来将所有js文件压缩成一个文件,Closure Compiler的高级压缩压缩比非常高,即便你下载的是压缩版引擎,也可以获得可观的压缩比。具体压缩步骤如下:[/size]
[size=2]下载Closure Compiler的jar程序文件[/size]
[size=2]按照自己的环境配置build.xml[/size]
[size=2]在控制台运行ant命令[/size]
[size=2]将页面中的所有js引用删除,引入打包出的game.min.js[/size]
[size=2]请注意,你不可以在html页面中写任何js脚本,所有js脚本都必须一起打包起来,否则会引起错误。[/size]
[size=4]注意[/size]
[size=2]当你通过服务器访问游戏页面的时候,你将在控制台中发现一个错误提示: "Failed to load resource: the server responded with a status of 404 (Not Found)",提示project.json文件找不到[/size]
[size=2]这是正常现象,并不是问题,你可以忽略它。或者可以添加一个空的project.json文件来避免这个错误报告。[/size]
[size=4]下一步[/size]
[size=2]这一章节中讲述的主要是适合纯Web开发者所使用的工作流,如果你想更完整得体验Cocos2d-JS的强大跨平台能力,我们在下一章节将讲述如何使用Cocos2d-JS完整包来开发跨浏览器以及原生平台的跨端游戏。[/size]
[size=2][s:5] [s:5] 欢迎大家反馈意见呀。[/size]


