如何將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(