溫馨提示×
您好，登錄后才能下訂單哦！
點擊 登錄注冊 即表示同意《億速云用戶服務條款》
您好，登錄后才能下訂單哦！
【嘮叨】
本節要講的是如果將自己寫的C++類注冊進Lua環境，讓Lua去調用自定義的C++類。
網上有很多都是用原始的tolua++工具來注冊C++類的，我看了很多這樣的教程，感覺操作起來十分麻煩，而且也很難看懂他們到底在講什么。
其實，在cocos2dx v3.2版本中，提供了bindings-generator腳本來封裝toLua++的用法，從而節省了工作量。
【致謝】
http://segmentfault.com/blog/hongliang/1190000000718145 （講得非常好！）
http://cn.cocos2d-x.org/article/index?type=code-ide&url=/doc/cocos-docs-master/manual/code-ide/binding-custom-class-to-lua/zh.md （官方文檔）
【使用工具】
Windows7 x64
Cocos2dx v3.2
Cocos Code IDE 1.0.1 （支持自定義類的智能提示功能）
python 2.7.x（v3.2版本不一定要2.7.3，我用2.7.8也成功了的）
NDK r9d ，解壓并配置環境變量NDK_ROOT（v3.2版本不一定要r9b，我用r9d成功了的）
pyyaml ，安裝到 "Python的安裝目錄\Lib\site-packages"
http://pyyaml.org/download/pyyaml/PyYAML-3.10.win32-py2.7.exe
Cheetah ，并解壓到 "Python的安裝目錄\Lib\site-packages"
https://raw.github.com/dumganhar/my_old_cocos2d-x_backup/download/downloads/Cheetah.zip
dos2unix ，windows下可能在執行腳本時有這個錯誤。
解壓到一某個目錄下面, 并設置PATH環境變量的值指向bin目錄下。
http://waterlan.home.xs4all.nl/dos2unix/dos2unix-7.1-win32.zip
【MAC】參見：http://blog.csdn.net/guo_hongjun1611/article/details/39852873
【綁定方法】
以下介紹的是在 Windows7 + VS2013 + Cocos Code IDE。
并使用Cocos Code IDE創建的Lua項目，綁定方法。
1、將自定義的C++代碼放在 frameworks\runtime-src\Classes 下
當然放哪里是隨意的，我喜歡放在Classes下。
2、添加自定義類的.ini文件
在 frameworks\cocos2d-x\tools\tolua 中，復制一份該文件夾下cocos2dx.ini的配置信息，然后修改一些參數，改成我們自定義類的參數。
以下列出需要修改的參數配置：
[custom_api] # prefix會被添加到生成的函數.你也可以選擇不添加這個到你的模板 prefix = custom_api # 所有的類都會嵌入到這個命名空間 target_namespace = my # 類所在的路徑，如果有多個，用空格隔開 headers = %(cocosdir)s/../runtime-src/Classes/PanZoomLayer.h # 需要注冊的類，如果有多個，用空格隔開 classes = PanZoomLayer # 不提供給Lua的public成員函數 skip = PanZoomLayer::[onTouchesBegan onTouchesMoved onTouchesEnded init onEnter onExit update] # 這些全空就好了 rename_functions = rename_classes = remove_prefix = classes_have_no_parents = base_classes_to_skip = abstract_classes = script_control_cpp = no
3、genbindings.py 添加自定義的配置.ini
在 frameworks\cocos2d-x\tools\tolua 的 genbindings.py 中的129行找到 cmd_args 。
將我們自定義的 custom_api.ini 添加進去，并注釋掉其他.ini（這些已經不需要重新生成）
4、運行 genbindings.py 腳本
在終端運行 genbindings.py 腳本。
在這里，我是直接寫了一個批處理文件 .bat 。
注意：只要需要用到的工具都下載，安裝，配置好了，一般就能生成成功。
生成失敗的，基本都是因為工具沒有配置好。
生成成功后，在 frameworks\cocos2d-x\cocos\scripting\lua-bindings\auto 中會找到我們生成的C++的橋接文件， lua_custom_api_auto.cpp 和 lua_custom_api_auto.hpp 。
其中 lua_custom_api_auto.hpp 中的 register_all_custom_api 就是我們用來將PanZoomLayer類注冊到Lua環境中的關鍵函數。
以及在 frameworks\cocos2d-x\cocos\scripting\lua-bindings\auto\api 中也能夠找到我們提供給Lua調用的接口文件。
5、編譯注冊到Lua
注冊自定義類的函數在我們的 lua_custom_api_auto.hpp 中可以看到。
register_all_custom_api(lua_State* tolua_S)
使用 VS2013 打開 frameworks\runtime-src\proj.win32 下的工程。
（1）將自定義的類 PanZoomLayer 添加到項目工程的Classes下。
（2）將 lua_custom_api_auto.cpp、lua_custom_api_auto.hpp 添加到工程liblua的auto下。
（3）添加lualib工程的文件搜索路徑。
將 $(EngineRoot)../runtime-src/Classes 路徑加進去。
（4）編輯 frameworks\runtime-src\Classes 下的入口類 AppDelegate.cpp
> 添加：lua_custom_api_auto.hpp 頭文件
> 注冊：register_all_custom_api(state)
> 注意：register_all_custom_api 的上下兩句話，必須加上！
（5）編譯運行整個項目，完成C++類的注冊到Lua。
然后就可以再Lua中愉快的使用自定義的類了！
【開啟智能提示】
雖然我們將我們自定義的C++類注冊到了Lua中調用，但是在Cocos Code IDE中卻沒有我們自定義類的智能提示。
我們需要修改一些配置，讓Cocos Code IDE加上對我們自定義類的智能提示。
1、Cocos2dx引擎中的智能提示
首先我們來看一下Cocos Code IDE中cocos2dx引擎的智能提示是怎么搞的。
隨便找個 cc.Label 把！
我們按住鍵盤的 ctrl 鍵，然后點擊 cc 和 Label，就會跳轉到聲明它們的地方。
文件跳轉到了如下兩幅圖的地方：
可能看到以上兩幅圖，你就明白應該怎么給我們自定義的C++類加上智能提示了吧？
我們先找到以下文件路徑：（可能每個人的不一樣）
\CocosCodeIDE\configuration\org.eclipse.osgi\bundles\61\1\.cp\resource\cocos2dx-3.2
可以發現該路徑下有一個 api.zip 這個壓縮包。
我們將其 api.zip 解壓出來看看里面都是什么東西。
可以發現里面全是cocos2dx的C++類提供給Lua的接口聲明。
這些也就是IDE中智能提示的原因。
2、添加自定義類的智能提示（方式一）
我們仿照 api.zip 中的 cc.lua 和 label.lua 來寫一個自定義類的接口聲明。
> my.lua ：聲明命名空間
> PanZoomLayer.lua ：聲明自定義類。（這個在使用腳本綁定時，自動生成）
其中 PanZoomLayer.lua 在使用 genbindings.py 腳本時，就自動生成了的。
就在 frameworks\cocos2d-x\cocos\scripting\lua-bindings\auto\api 中。
那么，我們再寫一個 my.lua ，也放在這個目錄下好了。
其中，my.lua 代碼如下：
-------------------------------- -- @module my -------------------------------------------------------- -- the my PanZoomLayer -- @field [parent=#my] PanZoomLayer#PanZoomLayer PanZoomLayer preloaded module return nil
PanZoomLayer.lua 代碼如下：
然后我們將 my.lua 和 PanZoomLayer.lua 一并壓縮到 myapi.zip 中。
就放在 \frameworks\cocos2d-x\cocos\scripting\lua-bindings\auto\api 中好了。
然后我們打開Cocos Code IDE的工程項目，配置屬性。
Lua->Build Path->Libraries->Add External Zips。
將我們的 myapi.zip 壓縮包添加進去，點擊“確定”。
這樣，就可以在 Cocos Code IDE 中愉快的玩我們自定義的類了。
有智能提示，就是爽啊！！！
3、添加智能提示（方式二）
通過上面的方式一的方法雖然可以有智能提示，可是后來我發現定義的命名空間 my 卻無法識別。這樣的結果將導致創建的 my.PanZoomLayer:create() 賦值給 self 的成員 self.pzLayer 后，繼續使用 self.pzLayer 時，對應的函數又無法提示了。
所以這里我們通過修改官方智能提示包 api.zip ，來達到更加的智能提示的效果。
操作方法和方式一類似，我們先將官方的提示包 api.zip 解壓出來，最好將其備份一份。
文件在：
\Cocos Code IDE\configuration\org.eclipse.osgi\bundles\61\1\.cp\resource\cocos2dx-3.2
然后我們將我們自定義提示包 my.lua 和 PanZoomLayer.lua 放入 api 文件夾中。
然后在 api 文件夾中找到 global.lua 這個全局聲明文件。
將我們自定義的命名空間 my 聲明進去。
-- the my module -- @field [parent=#global] my#my my preloaded module
保存關閉，將 api 文件夾壓縮成 api.zip 包。
然后刷新我們的項目工程，然后再來試試我們自定義類的智能提示效果。
可以發現，自定義的類的智能提示已經和 官方的智能提示功能 完全一致了。
又可以愉快的玩耍啦！！！
【遇到的問題】
1、腳本生成出錯
這些出錯都是由于沒有配置 pyyaml、Cheetah、dos2unix 引起的，都下過來配置一下即可。
2、編譯到Android手機出錯
上面的配置完成后IOS的部分是可以正常運行的，但是這個時候編譯android時不通過的。
因為 AppDelegate.cpp 里面調用的 register_all_MyClass(L) 方法在android不存在，android的項目里并沒有配置去編譯對應的 PanZoomLayer.cpp 文件和后續生成的 lua_custom_api_auto.cpp。
所以需要在android端配置Android.mk文件，讓項目編譯時去編譯這兩個C++文件才行。
（1）首先配置JNI下面的Android.mk文件，讓JNI部分編譯時去編譯PanZoomLayer.cpp：
編輯 frameworks/runtime-src/proj.android/jni/Android.mk
在 LOCAL_SRC_FILES 參數的后面添加：（注意后面的 \ ，僅最后一行不加斜杠）
../../Classes/PanZoomLayer.cpp
在 LOCAL_C_INCLUDES 參數的后面添加：（注意后面的 \ ，僅最后一行不加斜杠）
$(LOCAL_PATH)/../../Classes
（2）然后配置 frameworks/cocos2d-x/cocos/scripting/lua-bindings/Android.mk文件。
在 LOCAL_SRC_FILES 參數的后面添加：（注意后面的 \ ，僅最后一行不加斜杠）
auto/lua_custom_api_auto.cpp
在 LOCAL_C_INCLUDES 參數的后面添加：（注意后面的 \ ，僅最后一行不加斜杠）
$(LOCAL_PATH)/../../../../runtime-src/Classes
（3）然后 Build-Runtime，將項目在Android端編譯一下。
（4）若編譯成功，就可以在Android手機上測試了！
免責聲明：本站發布的內容（圖片、視頻和文字）以原創、轉載和分享為主，文章觀點不代表本網站立場，如果涉及侵權請聯系站長郵箱：is@yisu.com進行舉報，并提供相關證據，一經查實，將立刻刪除涉嫌侵權內容。
