爱程序网

快速入门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了

 

 

 

    

关于爱程序网 - 联系我们 - 广告服务 - 友情链接 - 网站地图 - 版权声明 - 人才招聘 - 帮助