快速入门cocos2d-x jsbinding

如果你是一个cocos2d-x的老手，那你可以忽略这篇博文，如果你是一个接触过javascript，想通过HTML5做游戏的，但是苦于不知道如何下手，那么这篇博文可能会帮到你。

cocos2dx-jsb的主要运用的语言是javascript，其实简单的说jsb就是cocos2d-x提供的C++ -> javascript的一系列接口，通过编写js的脚本来调动C++的接口做一系列的动作。实际的运行顺序是:js执行接口->spidermonkey解析js，判断调用了哪个C++接口->执行2dx的相应的接口->opengl 渲染... 知道了这个顺序以后，关键是怎么来写js呢？那下面来认识下cocos2d-html5

Cocos2D-HTML5是基于HTML5规范集的Cocos2D引擎的分支，于2012年5月发布,到现在差不多有1年多了，功能，API已经趋向于稳定，基本上每个月都有大的版本迭代更新，现在同时支持canvas和webgl渲染，有些功能比如批渲染，这个canvas是不能做的，如果浏览器支持webgl就可以运行。cocos2d-html5的API是向下兼容jsb的，也就是说有些api在jsb里面是执行不了的，但是90%以上的canvasAPI都是一致的，这一块的话jsb开发者和cocos2d-h5开发者两边都在不断的同步。绝大部分常用的API都是足够使用的，等熟悉了这两个框架以后就可以做到用cocos2d-h5在浏览器中调试一遍，然后在用jsb在手机上运行是一样的效果，也就是我们所说的一套代码，跨平台运行。但是要达到这样一个效果，需要了解这两个框架，了解的越深入，碰到问题处理起来越是游刃有余。

coding的最好的学习就是实践，jsb入门可以先从cocos2d-h5入门做起，首先需要配置一下web开发环境，这个比手机开发环境搭建简单多了，你需要一个web服务器，apache或者tomcat都可以（个人推荐apache）,一个chrome最新的浏览器(当然firefox也可以，chrome调试，性能最好),然后从cocos2d-x官网(http://www.cocos2d-x.org/)中下载最新的cocos2d-h5压缩包，解压以后放到apache或者tomcat对应的资源目录下面，然后输入URL指向到cocos2d-h5包里面对应的index.html,如果没有什么问题的话就可以看到cocos2d-h5的页面了，到此你已经完成了h5环境的搭建，如果你对此还有疑问，可以看官方的详细H5入门上手说明 http://www.cocos2d-x.org/projects/cocos2d-x/wiki/Getting_Started_with_Cocos2d-html5。

如果你完成了上述HelloWorld的创建后，那就可以试着创建jsb的环境了，mac版的ios环境和android环境都非常容易，平时开发可以用chrome浏览器跑通功能->ios模拟器验证原生环境->做完一个模块用iphone真机测试性能效率，这里重点说一下window环境，jsb的环境其实就是cocos2dx的环境，官方有一篇win7下如何配置android环境的wiki http://www.cocos2d-x.org/projects/cocos2d-x/wiki/How_to_set_up_the_android_cocos2d-x_development_environment_on_Windows_7

基本上把会遇到的问题都详细描述清楚了，除此之外官方wiki还有个问题没有写到，某些win7系统编译工程的时候会发现无法把资源目录拷贝到assets目录下面，原因是cygwin的权限不够，需要把cygwin的权限设为root权限，然后重启电脑，应该就可以了，修改cygwin Root方法请自行百度。

完成windows下面android配置后，我们用创建工程工具脚本创建一个跨平台的工程。在cygwin中执行脚本

cd /cocos2d-x/tools/project-createor/

#其中Clams是project名,com.supersell.crash是安卓中主Activity所在的package名，这两个名字都可以根据项目来改,language对应的是变成语言，jsb项目就是javascript

python create_project.py -project Clams -package com.supersell.crash -language javascript

创建完工程以后，会在cocos2d-x/projects 下面生成Clams目录，打开目录结构如下

Classes目录，存放了AppDelegate.cpp和AppDelegate.h文件这两个文件，这两个文件是项目的C++入口，jsb接口的引入，加载入口js都是在这里，具体请看

 1 #include "cocos2d.h"
 2 #include "SimpleAudioEngine.h"
 3 #include "ScriptingCore.h"
 4 #include "generated/jsb_cocos2dx_auto.hpp"
 5 #include "generated/jsb_cocos2dx_extension_auto.hpp"
 6 #include "jsb_cocos2dx_extension_manual.h"
 7 #include "cocos2d_specifics.hpp"
 8 #include "js_bindings_chipmunk_registration.h"
 9 #include "js_bindings_system_registration.h"
10 #include "js_bindings_ccbreader.h"
11 #include "jsb_opengl_registration.h"
12 #include "XMLHTTPRequest.h"
13 #include "jsb_websocket.h" 
14 
15 USING_NS_CC;
16 using namespace CocosDenshion;
17 
18 AppDelegate::AppDelegate()
19 {
20 }
21 
22 AppDelegate::~AppDelegate()
23 {
24     CCScriptEngineManager::purgeSharedManager();
25 }
26 
27 bool AppDelegate::applicationDidFinishLaunching()
28 {
29 　　 // 从这里开始实例化导演类
30     // initialize director
31     CCDirector *pDirector = CCDirector::sharedDirector();
32     pDirector->setOpenGLView(CCEGLView::sharedOpenGLView());
33     
34     // turn on display FPS
35     pDirector->setDisplayStats(true);
36     
37     // set FPS. the default value is 1.0/60 if you don't call this
38     pDirector->setAnimationInterval(1.0 / 60);
39     
40 　　 // 实例化脚本核心类，这个类封装了spidermonkey的一些接口，基本上所有的js脚本处理都由这个类来执行
41     ScriptingCore* sc = ScriptingCore::getInstance();
42     // 从这里开始注册脚本绑定，如果以后自己写了新的绑定，也需要在这里执行注册
43     sc->addRegisterCallback(register_all_cocos2dx);
44     sc->addRegisterCallback(register_all_cocos2dx_extension);
45     sc->addRegisterCallback(register_all_cocos2dx_extension_manual);
46     sc->addRegisterCallback(register_cocos2dx_js_extensions);
47     sc->addRegisterCallback(register_CCBuilderReader);
48     sc->addRegisterCallback(jsb_register_chipmunk);
49     sc->addRegisterCallback(jsb_register_system);
50     sc->addRegisterCallback(JSB_register_opengl);
51     sc->addRegisterCallback(MinXmlHttpRequest::_js_register);
52     sc->addRegisterCallback(register_jsb_websocket);
53 
54     sc->start();
55     
56     CCScriptEngineProtocol *pEngine = ScriptingCore::getInstance();
57     CCScriptEngineManager::sharedManager()->setScriptEngine(pEngine);
58     // main.js就是js的入口文件，存放在Resources下面，换新的js需要注意路径
59     ScriptingCore::getInstance()->runScript("main.js");
60        
61     return true;
62 }
63 
64 void handle_signal(int signal) {
65     static int internal_state = 0;
66     ScriptingCore* sc = ScriptingCore::getInstance();
67     // should start everything back
68     CCDirector* director = CCDirector::sharedDirector();
69     if (director->getRunningScene()) {
70         director->popToRootScene();
71     } else {
72         CCPoolManager::sharedPoolManager()->finalize();
73         if (internal_state == 0) {
74             //sc->dumpRoot(NULL, 0, NULL);
75             sc->start();
76             internal_state = 1;
77         } else {
78             sc->runScript("hello.js");
79             internal_state = 0;
80         }
81     }
82 }
83 
84 // This function will be called when the app is inactive. When comes a phone call,it's be invoked too
85 void AppDelegate::applicationDidEnterBackground()
86 {
87     CCDirector::sharedDirector()->stopAnimation();
88     SimpleAudioEngine::sharedEngine()->pauseBackgroundMusic();
89     SimpleAudioEngine::sharedEngine()->pauseAllEffects();
90 }
91 
92 // this function will be called when the app is active again
93 void AppDelegate::applicationWillEnterForeground()
94 {
95     CCDirector::sharedDirector()->startAnimation();
96     SimpleAudioEngine::sharedEngine()->resumeBackgroundMusic();
97     SimpleAudioEngine::sharedEngine()->resumeAllEffects();
98 }

如果没有自己新写的js脚本绑定，这个类最多只需要修改入口js就行

pro.android:安卓项目工程，我们来看下他里面的结构

几个重要的文件说明下,

AndroidManifest.xml:用来记录安卓安装权限，app横屏竖屏等的一些配置

assets:资源目录,编译项目的时候，会自动将Rescourse目录下的资源(图片,js)和框架js都拷贝到这个目录下，每次编译都是直接覆盖的，所以如果你需要把一部分图片打包到apk里面，你只要把相应的资源存放到Rescourse目录。

bin:编译好的java文件会存放到这里,跑过build_native.sh才有

jni:这个目录下面存放了一个重要的文件，Android.mk，这个是项目的入口mk文件，ndk的项目编译从这里开始找，大部分情况你不需要动他，以后有自己新写的C++扩展，你需要在这个mk文件中声明。

libs:存放了编译好的cocos2d-x动态库(.so),跑过build_native.sh才有。

build_native.sh:一键编译脚本，编译项目的时候你需要先执行他，也可以在eclipse中直接右键项目run，其实也是通过脚本运行的，运行的前提需要配置好cocos2dx的安卓环境。

===========================

proj.ios:ios项目环境，直接双击.xcodeproj就能跑了，当然需要改入口文件的话还是参照上面的改法。

Resources:编写的脚本，还有打包进去的图片都存放在这里。

如果顺利的话，编译完工程后连上手机调试，你就可以直接看到helloWorld了