如何将C++绑定至JAVASCRIPT
转 http://www.cocos2d-x.org/docs/manual/framework/native/wiki/how-to-bind-c++-to-javascript/zh
简介
Cocos2d JS API接口与Cocos2d-x、Cocos2d-iphone及Cocos2d-html5相同。Cocos2d-html5是经过浏览器在移动设备上运行，Cocos2d-iphone和Cocos2d-x内的JSB能够大幅提高引擎性能。全部图形、渲染及物理库代码都会在本地运行，只有游戏逻辑会在Java脚本中运行。javascript
将游戏代码移植到脚本语言不只仅是基于跨平台角度，还有不少其余的优点。由于代码是未编译的，全部在运行时期能够替换，从而加快测试周期。php
为何选择Javascript？
Javascript脚本优势以下：html
- 更快开发速度
- 很是适合原型
- 比其余编译语言简单易懂
- 可移植性
支持JSB绑定的项目：html5
- Cocos2d-x
- Chipmunk
- CocosBuilder Reader
这意味着你可使用CocosBuilder做为实际诶编辑器建立Cocos2d-x+Chipmunk游戏。Cocos2D附带“Watermelon With Me”样本游戏，该游戏用到了cocos2d、chipmunk物理库及CocosBuilder。java
Javascript性能
Cocos2d-X使用SpiderMonkey和Firefox JS virtual machine (VM)来执行JS代码。
JS VM可扩展支持全部cocos2d引擎、Chipmunk库以及CocosBuilder Reader API接口。因此用JS建立“CCSprite”时，其实是在建立C++“CCSprite”。用JS建立动做时，其实是在建立C++动做。在用JS建立粒子系统时，实际是在建立C++粒子系统以此类推。
这种方法的速度要比HTML5快10到20倍，即使HTML5采用“directCanvas”等加速器。python
基本上全部cocos2d、Chipmunk库或CocosBuilder Reader API接口几乎都会以本地速度运行。可是应该注意如下状况：android
- 当垃圾收集器（garbage collector）运行时性能可能会下降。解决方法：不要建立不少JS对象，尽量重复利用。
- 若是主循环太复杂可能会下降性能。解决方法：profile（绘出轮廓）你的JS代码，若是没法优化代码，可在C++中编写昂贵（expensive）的部分，而后为这些函数建立JSB绑定。
绑定生成器
如何工做
绑定生成器（Bindings-generator）是一个Java脚本绑定生成器，会生成自动绑定spidermonkey目标Java脚本的C/C++代码。
GitHub资源库工具下载：https://github.com/cocos2d/bindings-generatorc++
要求
- 下载绑定生成器，本机路径/Users/iven/Dev/bindings-generator
-
为了在Mac OS X中安装运行MacPort端口，系统必需要已经安装苹果的“Command Line Developer Tools”（命令行开发者工具）。Xcode 4及之后版本的用户首先须要经过启动或运行Xcode接受Xcode EULA。git
xcodebuild -license -
下载安装MacPort：http://www.macports.org/install.php。
注意：若是是Homebrew用户，应该先卸载Homebrew。由于Homebrew不兼容MacPort。
同时执行MacPort的“selfupdate”命令以确保安装最新的发布版本。githubsudo port -v selfupdate当更新完成以后，使用MacPort在命令行中安装python依赖（dependencies）
sudo port install python27 py27-yaml py27-cheetah你会看到以下所示：
-
下载llvm-3.3：http://llvm.org/releases/download.html#3.3，解压至$HOME/bin目录。若是没有bin目录，请建立一个bin目录，将未解压的ZIP压缩包重命名为“clang+llvm-3.3”。
最后目录以下所示：/Users/guanghui/bin/clang+llvm-3.3（guanhui是本机的主目录名字） -
下载Android-NDKR8 http://dl.google.com/android/ndk/android-ndk-r8e-darwin-x86_64.tar.bz2并解压。
样本代码
绑定生成器资源库中包括一个样本测试用例。打开bindings-generator/test/simple_test文件夹。
配置
-
根据本身的环境个性化设置“test/userconf.ini”和“test/user.cfg”文件。
注意：应该移除后缀为“.sample”的文件如“user.cfg.sample”和“userconf.ini.sample”[DEFAULT] androidndkdir=/Users/iven/Dev/android-ndk-r8c clangllvmdir=/Users/iven/Dev/clang+llvm-3.1-x86_64-apple-darwin11 cxxgeneratordir=/Users/iven/Dev/bindings-generator-masteruser.cfg配置以下所示
PYTHON_BIN=/opt/local/Library/Frameworks/Python.framework/Versions/2.7/bin/ python2.7 -
运行测试样本
./test.sh若是环境设置正确，你会看到以下所示：
Errors in parsing headers: 1. <severity = Warning, location =<SourceLocation file None, line 0, column 0>, details = "argument unusedduring compilation: '-nostdinc++'">不用担忧这个警告，你已完成运行，测试用例会建立一个包含3个文件的“simple_test_bindings”目录。
-
一个绑定类的.hpp头文件
-
一个实现绑定类的.cpp文件
-
一个介绍如何（从Java脚本）调用C++类暴露方法的.js文件。
运行测试
-
Create a JS base Cocos2d-x project. 建立基于JS的Cocos2d-x项目
-
将“simple_Test folder”文件夹和“simple_test_binding”文件夹添加到项目中
-
修改“autogentestbindings.cpp”中的注册函数以下：
void register_all_autogentestbindings(JSContext* cx, JSObject* obj) { jsval nsval; JSObject *ns; JS_GetProperty(cx, obj, "ts",&nsval); if (nsval == JSVAL_VOID) { ns = JS_NewObject(cx, NULL, NULL, NULL); nsval = OBJECT_TO_JSVAL(ns); JS_SetProperty(cx, obj, "ts",&nsval); } else { JS_ValueToObject(cx,nsval, &ns); } obj = ns; js_register_autogentestbindings_SimpleNativeClass(cx, obj); }注意：若是你将“ts”添加到“test.ini”文件中的“target_namespace”变量里，便会自动生成代码。无需修改。
target_namespace =ts -
在“AppDelegate”中注册
包含头文件“autogentestbindings.hpp”而后注册回调函数：
sc->addRegisterCallback(register_all_autogentestbindings); -
在“hello.js”文件适当地方增长如下代码。本机将“init f”函数放在第一个场景。
var myClass=new ts.SimpleNativeClass(); var myStr=myClass.returnsACString(); var label = cc.LabelTTF.create(myStr, "Helvetica", 20.0);
限制
绑定生成器存在如下两个限制
- 自变量数字参数没法工做，因此须要手动编写包装器
- 表明类没法工做，因此须要手动绑定，详见下一部分。
手动 JSB 绑定
本指南将介绍利用Cocos2d-x 2.14模板如何在本身的项目中实现JSB绑定。
首先用Cocos2d-js模板建立项目。其次，咱们会介绍如何一步一步从JS调用本地函数。最后你便会学会如何从本地代码调用JS代码了。
如今让咱们开始！本机使用的Mac OS X做为开发环境。
步骤1. 用Cocos2dx-js模板建立新项目，同时新建一个即将绑定至JS的C++类。
将项目命名为“JSBinding”而后点击“Next”、“ Create”
新建一个类而后实现这个类，等会再将其绑定至JS。
按“command+N”新建一个C++类并命名为“JSBinding”，路径为“OS X\C and C++\C++ Class”。
将如下代码添加到“JSBinding.h”文件中。
#include "cocos2d.h"
#include "ScriptingCore.h" // Define a namespace to manage your code and make your code clearly namespace JSB { class JSBinding: public cocos2d::CCObject { public: static cocos2d::CCScene* scene(); virtual bool init(); CREATE_FUNC(JSBinding); void functionTest(); }; }
如今实现JSBinding.cpp中的类。以下所示：
bool JSB::JSBinding::init(){ bool bRef = false; do{ cocos2d::CCLog("JSB init..."); bRef = true; } while (0); return bRef; } void JSB::JSBinding::functionTest(){ cocos2d::CCLog("Function test..."); }
步骤2. 将C++代码绑定至Java脚本代码
按“command+N”新建C++类，而后命名“JSB_AUTO”路径“OS X\C and C++\C++ Class”。
往“JSB_AUTO.h”文件中增长一些代码
#include "jsapi.h"
#include "jsfriendapi.h" #include "ScriptingCore.h" #include "JSBinding.h" void register_all(JSContext* cx, JSObject* obj);
而后注意“JSB_AUTO.cpp”的实现。
#include "jsapi.h"
#include "jsfriendapi.h" #include "ScriptingCore.h" #include "JSBinding.h" void register_all(JSContext* cx, JSObject* obj);
而后注意“JSB_AUTO.cpp”的实现。
#include "cocos2d.h" #include "cocos2d_specifics.hpp" // Binding specific object by defining JSClass JSClass* jsb_class; JSObject* jsb_prototype; // This function is mapping the function “functionTest” in “JSBinding.cpp” JSBool js_functionTest(JSContext* cx, uint32_t argc, jsval* vp){ JSBool ok = JS_TRUE; JSObject* obj = NULL; JSB::JSBinding* cobj = NULL; obj = JS_THIS_OBJECT(cx, vp); js_proxy_t* proxy = jsb_get_js_proxy(obj); cobj = (JSB::JSBinding* )(proxy ? proxy->ptr : NULL); JSB_PRECONDITION2(cobj, cx, JS_FALSE, "Invalid Native Object"); if (argc == 0) { cobj->functionTest(); JS_SET_RVAL(cx, vp, JSVAL_VOID); return ok; } JS_ReportError(cx, "Wrong number of arguments"); return JS_FALSE; } JSBool js_constructor(JSContext* cx, uint32_t argc, jsval* vp){ cocos2d::CCLog("JS Constructor..."); if (argc == 0) { JSB::JSBinding* cobj = new JSB::JSBinding(); cocos2d::CCObject* ccobj = dynamic_cast<cocos2d::CCObject*>(cobj); if (ccobj) { ccobj->autorelease(); } TypeTest<JSB::JSBinding> t; js_type_class_t* typeClass; uint32_t typeId = t.s_id(); HASH_FIND_INT(_js_global_type_ht, &typeId, typeClass); assert(typeClass); JSObject* obj = JS_NewObject(cx, typeClass->jsclass, typeClass->proto, typeClass->parentProto); JS_SET_RVAL(cx, vp, OBJECT_TO_JSVAL(