cocos2d-js Mac下的JSB绑定步骤

cocos2d-js由于采用js语言，使得做一些native的功能比较受限，例如文件和目录操作、socket操作等。逼不得已，这时我们就不得不做jsbinding了。。

官方提供的jsbinding方法还是很人性化的，但是网上根本没有找到合适的资料，我就自己先写一篇吧。

用cocos new命令创建工程之后，在 "工程目录/tools/bindings-generator" 目录下有一个generator.py脚本，test目录下有官方示例，这些都是我们需要的。

步骤开始：

1、安装python2.7。然后安装PyYAML和Cheetah，不同平台安装方法可能有区别，Mac下直接到PyYAML和Cheetah的解压目录下执行sudo ./setup.py就可以。

2、把 "工程目录/tools/bindings-generator/test" 下面的test.ini、test.sh、userconf.ini.sample这三个文件拷贝一份到自己能找到的地方，并把userconf.ini.sample重命名为userconf.ini。

3、修改userconf.ini，指定androidndkdir、clangllvmdir、cxxgeneratordir的路径。

4、修改test.ini，需要修改的有：引用的头文件的路径、绑定的类名、命名空间。下面是我的配置，使用我的配置，只需要修改前7行就可以。后面的可以不管。

 [testandroid]
 name = red_bindings
 prefix = red_bindings_auto
 classes = RedSprite RedClass
 cocosdir = /Users/staff/Documents/Red_Test/jsb_test/frameworks/js-bindings/cocos2d-x
 customdir = /Users/staff/Documents/Red_Test/jsb_test/frameworks/runtime-src/Classes
 headers = %(customdir)s/RedBindings.h
 target_namespace = red

 android_headers = -I%(androidndkdir)s/platforms/android-/arch-arm/usr/include -I%(androidndkdir)s/sources/cxx-stl/gnu-libstdc++/4.7/libs/armeabi-v7a/include -I%(androidndkdir)s/sources/cxx-stl/gnu-libstdc++/4.7/include -I%(androidndkdir)s/sources/cxx-stl/gnu-libstdc++/4.8/libs/armeabi-v7a/include -I%(androidndkdir)s/sources/cxx-stl/gnu-libstdc++/4.8/include
 android_flags = -D_SIZE_T_DEFINED_

 clang_headers = -I%(clangllvmdir)s/lib/clang/3.3/include
 clang_flags = -nostdinc -x c++ -std=c++ -U __SSE__

 cocos_headers = -I%(cocosdir)s -I%(cocosdir)s/cocos -I%(cocosdir)s/cocos/editor-support -I%(cocosdir)s/cocos/platform/android

 cocos_flags = -DANDROID

 extra_arguments = %(android_headers)s %(clang_headers)s %(customdir)s %(cocos_headers)s %(android_flags)s %(clang_flags)s %(cocos_flags)s %(extra_flags)s

 remove_prefix =
 skip =
 base_objects =
 abstract_classes =
 classes_have_type_info = no
 rename =
 rename_functions =
 rename_classes =
 # classes for which there will be no "parent" lookup
 classes_have_no_parents =

 # base classes which will be skipped when their sub-classes found them.
 base_classes_to_skip =

 # Determining whether to use script object(js object) to control the lifecycle of native(cpp) object or the other way around. Supported values are 'yes' or 'no'.
 script_control_cpp = yes

red_bindings.ini

5、修改test.sh，第39行修改CXX_GENERATOR_ROOT，指向 "工程目录/tools/bindings-generator" 就可以。

6、修改最后一行，指定test.ini的路径和生成代码的路径。下面是我的配置：

 #!/bin/bash
 #
 # Usage:
 #   export NDK_ROOT=/path/to/NDK-r9b
 #   ./test.sh

 # exit this script if any commmand fails
 set -e

 # read user.cfg if it exists and is readable

 _CFG_FILE=$(dirname "$0")"/user.cfg"
 if [ -f "$_CFG_FILE" ];
 then
     if [ ! -r "$_CFG_FILE" ]; then
        echo "Fatal Error: $_CFG_FILE exists but is unreadable"
        exit
     fi
 fi

 # paths

 if [ -z "${NDK_ROOT+aaa}" ]; then
 # ... if NDK_ROOT is not set, use "$HOME/bin/android-ndk"
     NDK_ROOT="$HOME/bin/android-ndk"
 fi

 if [ -z "${PYTHON_BIN+aaa}" ]; then
 # ... if PYTHON_BIN is not set, use "/usr/bin/python2.7"
     PYTHON_BIN="/usr/bin/python2.7"
 fi

 # find current dir
 DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"

 # paths with defaults hardcoded to relative paths

 if [ -z "${CXX_GENERATOR_ROOT+aaa}" ]; then
     CXX_GENERATOR_ROOT="/Users/staff/Documents/Red_Test/jsb_test/tools/bindings-generator"
 fi

 echo "Paths"
 echo "    NDK_ROOT: $NDK_ROOT"
 echo "    PYTHON_BIN: $PYTHON_BIN"
 echo "    CXX_GENERATOR_ROOT: $CXX_GENERATOR_ROOT"
 echo "    TO_JS_ROOT: $TO_JS_ROOT"

 # check NDK version, must be r9b
 # if ! grep -q r9b $NDK_ROOT/RELEASE.TXT
 # then
 #     echo " Fatal Error: NDK r9b must be required!"
 #     exit
 # fi

 # check clang include path
 OS_NAME=$('uname')
 NDK_LLVM_ROOT=$NDK_ROOT/toolchains/llvm-3.3/prebuilt
 if [ ! -d "$DIRECTORY" ]; then
     NDK_LLVM_ROOT=$NDK_ROOT/toolchains/llvm-3.4/prebuilt
 fi
 case "$OS_NAME" in
     Darwin | darwin)
         echo "in darwin"
         if [ -d "$NDK_LLVM_ROOT/darwin-x86_64" ]; then
             NDK_LLVM_ROOT=$NDK_LLVM_ROOT/darwin-x86_64
         elif [ -d "$NDK_LLVM_ROOT/darwin-x86" ]; then
             NDK_LLVM_ROOT=$NDK_LLVM_ROOT/darwin-x86
         else
             echo $NDK_LLVM_ROOT
             echo " Fatal Error: $NDK_LLVM_ROOT doesn't contains prebuilt llvm 3.3 or 3.4"
             exit
         fi
         ;;
     Linux | linux)
         echo "in linux"
         if [ -d "$NDK_LLVM_ROOT/linux-x86_64" ]; then
             NDK_LLVM_ROOT=$NDK_LLVM_ROOT/linux-x86_64
         elif [ -d "$NDK_LLVM_ROOT/linux-x86" ]; then
             NDK_LLVM_ROOT=$NDK_LLVM_ROOT/linux-x86
         else
             echo " Fatal Error: $NDK_LLVM_ROOT doesn't contains prebuilt llvm 3.3 or 3.4"
             exit
         fi
         ;;
     *)
         echo " Fatal Error: Please run this script in linux or mac osx."
         exit
         ;;
 esac

 # write userconf.ini

 _CONF_INI_FILE="$PWD/userconf.ini"
 if [ -f "$_CONF_INI_FILE" ]
 then
     rm "$_CONF_INI_FILE"
 fi

 _CONTENTS=""
 _CONTENTS+="[DEFAULT]"'\n'
 _CONTENTS+="androidndkdir=$NDK_ROOT"'\n'
 _CONTENTS+="clangllvmdir=$NDK_LLVM_ROOT"'\n'
 _CONTENTS+="cxxgeneratordir=$CXX_GENERATOR_ROOT"'\n'
 _CONTENTS+="extra_flags="'\n'

 echo
 echo "generating userconf.ini..."
 echo ---
 echo -e "$_CONTENTS"
 echo -e "$_CONTENTS" > "$_CONF_INI_FILE"
 echo ---

 # Generate bindings for cocos2dx
 echo "Generating bindings for cocos2dx..."
 set -x

 LD_LIBRARY_PATH=${CXX_GENERATOR_ROOT}/libclang $PYTHON_BIN ${CXX_GENERATOR_ROOT}/generator.py /Users/staff/Documents/Red_Test/jsb_test/frameworks/bindingconf/red_bindings.ini -t spidermonkey -s testandroid -o ./simple_test_bindings

red_bindings.sh

7、执行刚才的sh文件应该就会在指定的目录生成绑定代码了。把生成的cpp和hpp文件复制到 "工程目录/frameworks/runtime-src/Classes" 中，修改AppDelegate.cpp，include刚生成的hpp，在applicationDidFinishLaunching函数中添加"sc->addRegisterCallback(register_all_red_bindings_auto);"（参数是注册绑定的函数指针，一般都是已"register_all"开头）。

8、编译runtime就可以了，实测在Mac、android、ios都可以。