【COCOS2DX-LUA 脚本开发之四】使用tolua++编译pk创建自定义类

此篇基本【COCOS2DX(2.X)_LUA开发之三】在LUA中使用自定义精灵(LUA脚本与自创建类之间的访问)及LUA基础讲解

在Lua第三篇中介绍了，如何在cocos2dx中使用Lua创建自定义类供Lua脚本调用使用，当时出于Himi对Lua研究不够深入，所以当时使用了笨方法手动添加的方式进行的，那么本篇将介绍利用tolua++快速将我们自定义的c2dx类嵌入，供 lua脚本使用。

首先介绍整个过程：

之前我们的过程： 自定义类->手动到LuaCoco2d.cpp中手动添加binding->lua使用

现在我们的过程是: 自定义类->使用tolua++工具编译到LuaCoco2d.cpp中->lua使用

下面进行详细步骤讲解：

步骤一：首先自定义类（这里Himi自定义类名 “MySprite”）

MySprite.h

1. // 
2. //  MySprite.h 
3. //  mtet 
4. // 
5. //  Created by Himi on 13-4-7. 
6. // 
7. // 
8.   
9. #ifndef __mtet__MySprite__ 
10. #define __mtet__MySprite__ 
11.   
12. #include "cocos2d.h" 
13. using namespace cocos2d; 
14.   
15. class MySprite : public CCSprite{ 
16. public: 
17.     static MySprite* createMS(const char* fileName); 
18. }; 
19. #endif /* defined(__mtet__MySprite__) */ 

MySprite.cpp

1. 2 
2. 3 
3. 4 
4. 5 
5. 6 
6. 7 
7. 8 
8. 9 
9. 10 
10. 11 
11. 12 
12. 13 
13. 14 
14. 15 
15. 16 
16. 17 
17. 18 
18. 19 
19. // 
20. //  MySprite.cpp 
21. //  mtet 
22. // 
23. //  Created by Himi on 13-4-7. 
24. // 
25. // 
26.   
27. #include "MySprite.h" 
28. MySprite* MySprite::createMS(const char* fileName){ 
29.     MySprite* sp = new MySprite(); 
30.     if(sp && sp->initWithFile(fileName)){ 
31.         sp->setPosition(ccp(100,100)); 
32.         sp->autorelease(); 
33.         return sp; 
34.     } 
35.     CC_SAFE_DELETE(sp); 
36.     return NULL; 
37. } 

步骤二：利用tolua++编译我们创建的pkg，将自定义类嵌入LuaCocos2d.cpp中

首先我们到cocos2dx引擎目录下找到tools下的tolua++文件夹。

然后你看到很多的pkg文件，你可以使用文本打开，就会发现都是Cocos2dx引擎封装的类、函数定义，如下CCSprite.pkg

1. /* 
2. typedef enum { 
3.     //! Translate with it's parent 
4.     CC_HONOR_PARENT_TRANSFORM_TRANSLATE =  1 << 0, 
5.     //! Rotate with it's parent 
6.     CC_HONOR_PARENT_TRANSFORM_ROTATE    =  1 << 1, 
7.     //! Scale with it's parent 
8.     CC_HONOR_PARENT_TRANSFORM_SCALE     =  1 << 2, 
9.     //! Skew with it's parent 
10.     CC_HONOR_PARENT_TRANSFORM_SKEW      =  1 << 3, 
11.   
12.     //! All possible transformation enabled. Default value. 
13.     CC_HONOR_PARENT_TRANSFORM_ALL       =  CC_HONOR_PARENT_TRANSFORM_TRANSLATE | CC_HONOR_PARENT_TRANSFORM_ROTATE | CC_HONOR_PARENT_TRANSFORM_SCALE | CC_HONOR_PARENT_TRANSFORM_SKEW, 
14.   
15. } ccHonorParentTransform; 
16. */ 
17. class CCSprite : public CCNode 
18. { 
19.     void setDirty(bool bDirty); 
20.     bool isDirty(void); 
21.   
22.     ccV3F_C4B_T2F_Quad getQuad(void); 
23.   
24.     CCRect getTextureRect(void); 
25.     //bool isUsesBatchNode(void); 
26.     bool isTextureRectRotated(void); 
27.   
28.     void setAtlasIndex(unsigned int uAtlasIndex); 
29.     unsigned int getAtlasIndex(void); 
30.     //void setUsesSpriteBatchNode(bool bUsesSpriteBatchNode); 
31.     void setTextureAtlas(CCTextureAtlas *pobTextureAtlas); 
32.     CCTextureAtlas* getTextureAtlas(void); 
33.     //void setSpriteBatchNode(CCSpriteBatchNode *pobSpriteBatchNode); 
34.     //CCSpriteBatchNode* getSpriteBatchNode(void); 
35.     //void setHonorParentTransform(ccHonorParentTransform eHonorParentTransform); 
36.     //ccHonorParentTransform getHonorParentTransform(void); 
37.     void setBlendFunc(ccBlendFunc blendFunc); 
38.     ccBlendFunc getBlendFunc(void); 
39.   
40.     CCPoint getOffsetPosition(void); 
41.   
42.     void ignoreAnchorPointForPosition(bool newValue); 
43.     void setFlipX(bool bFlipX); 
44.     void setFlipY(bool bFlipY); 
45.     bool isFlipX(void); 
46.     bool isFlipY(void); 
47.   
48.     void removeChild(CCNode* pChild, bool bCleanUp); 
49.     void removeAllChildrenWithCleanup(bool bCleanup); 
50.     void reorderChild(CCNode* pChild, int zOrder); 
51.     void addChild(CCNode* pChild); 
52.     void addChild(CCNode* pChild, int zOrder); 
53.     void addChild(CCNode* pChild, int zOrder, int tag); 
54.     void sortAllChildren(); 
55.     //void setPosition(CCPoint pos); 
56.     void setRotation(float rotation); 
57.     void setSkewX(float sx); 
58.     void setSkewY(float sy); 
59.     void setScale(float fScale); 
60.     void setScaleX(float fScaleX); 
61.     void setScaleY(float fScaleY); 
62.     void setVertexZ(float fVertexZ); 
63.     void setAnchorPoint(const CCPoint & anchor); 
64.     void setVisible(bool bVisible); 
65.   
66.     void setOpacity(GLubyte opacity); 
67.     GLubyte getOpacity(void); 
68.   
69.     void setColor(ccColor3B color3); 
70.     ccColor3B getColor(void); 
71.     void setOpacityModifyRGB(bool bValue); 
72.     bool isOpacityModifyRGB(void); 
73.   
74.     void setTexture(CCTexture2D *texture); 
75.     CCTexture2D* getTexture(void); 
76.   
77.     void updateTransform(void); 
78.     //void useSelfRender(void); 
79.     void setTextureRect(CCRect rect); 
80.     void setTextureRect(CCRect rect, bool rotated, CCSize size); 
81.     void setVertexRect(CCRect rect); 
82.     //void useBatchNode(CCSpriteBatchNode *batchNode); 
83.     void setDisplayFrame(CCSpriteFrame *pNewFrame); 
84.     bool isFrameDisplayed(CCSpriteFrame *pFrame); 
85.     CCSpriteFrame* displayFrame(void); 
86.     void setBatchNode(CCSpriteBatchNode* pBatchNode); 
87.     CCSpriteBatchNode* getBatchNode(); 
88.     void setDisplayFrameWithAnimationName(const char *animationName, int frameIndex); 
89.   
90.     static CCSprite* createWithTexture(CCTexture2D *pTexture); 
91.     static CCSprite* createWithTexture(CCTexture2D *pTexture, CCRect rect); 
92.     static CCSprite* createWithSpriteFrame(CCSpriteFrame *pSpriteFrame); 
93.     static CCSprite* createWithSpriteFrameName(const char *pszSpriteFrameName); 
94.     static CCSprite* create(const char *pszFileName, CCRect rect); 
95.     static CCSprite* create(const char *pszFileName); 
96.     static CCSprite* create(); 
97. }; 

没错，我们也会按照类似方式进行创建我们自定义类的pkg文件。

我们自定义一个文件（文本、xcode等都可以），后缀 .pkg ，然后将Himi自定义的MySprite类定义到pkg中，如下：

注意：只要自定义类.h中的内容，至于cpp的实现，binding后lua自动调用你类的函数

MySprite.pkg

1. class MySprite : public CCSprite{ 
2.     static MySprite* createMS(const char* fileName); 
3. }; 

在pkg中我只是定义了创建函数而已，至于更多的函数就交给大家自定义啦，另外我们注意书写pkg时是需要几条规则的，其实在tolua++这个文件夹中我们也能看到有一个名字叫 README 的文件，打开如下：

1. 1. Generating the lua<-->C bindings with tolua++ 
2.   
3.     Build scripts for windows (build.bat) and unix (build.sh) are provided 
4.     to generate the relevant files after modifying the .pkg files.  These 
5.     scripts basically run the following command: 
6.   
7.         tolua++.exe -L basic.lua -o LuaCocos2d.cpp Cocos2d.pkg 
8.   
9.     This will generate the bindings file and patch it with come cocos2dx 
10.     specific modifications. 
11.   
12.     On POSIX systems you can also just run "make" to build the bindings 
13.     if/when you change .pkg files. 
14.   
15. 2. Writing .pkg files 
16.   
17.     1) enum keeps the same 
18.     2) remove CC_DLL for the class defines, pay attention to multi inherites 
19.     3) remove inline keyword for declaration and implementation 
20.     4) remove public protect and private 
21.     5) remove the decalration of class member variable 
22.     6) keep static keyword 
23.     7) remove memeber functions that declared as private or protected 

这个文件声明了书写pkg的规则，不多赘述。

书写好我们的pkg之后，将pkg文件放置此tolua++文件夹下即可，然后配置我们tolua++工具。

继续在tolua++文件夹中解压tolua++.Mac.zip 文件，会得到一个tolua++的工具，如下图：

解压出工具之后，我们还要在tolua++文件夹中，配置tolua++路径，打开“build.sh”文件，如下：

这里 TOLUA 是tolua++工具的位置（路径后面要架上 /tolua++  表示这个工具），最下面配置的是编译后的luaCocos2d.cpp文件导出的位置，Himi这里配置到桌面，配置如下：

 最后，我们要将我们定义的pkg文件注册到 tolua++文件夹下的Cocos2d.pkg中，如下：

如上步骤都OK后，我们就可以使用“终端”，先cd到tolua++的文件夹下，然后使用“make”命令执行tolua++工具。

（如果这里终端不能正常执行， 请继续修改tolua++文件夹下的： makefile  ，将其路径配置一下即可。）

终端正常执行后，会在一开始指定的目录生成LuaCocos2d.cpp 文件，且其中已经binding好了自定义类，将生成的LuaCocos2d.cpp替换到你项目的/libs/lua/cocos2dx_support下的LuaCocos2d.cpp 文件。

Himi建议生成的LuaCocos2d.cpp 文件路径直接设置你的项目的/libs/lua/cocos2dx_support下很方便

注意：这时候LuaCoco2d.cpp中虽然已经binding了我们的自定义类，但是没有引用我们的头文件，所以我们还需要在LuaCocos2d.h中倒入我们自定义类.h 。

步骤三：Lua测试我们的自定义类

1. -- for CCLuaEngine traceback 
2. function __G__TRACKBACK__(msg) 
3.     print("----------------------------------------") 
4.     print("LUA ERROR: " .. tostring(msg) .. "\n") 
5.     print(debug.traceback()) 
6.     print("----------------------------------------") 
7. end 
8.   
9. local function main() 
10.     -- avoid memory leak 
11.     collectgarbage("setpause", 100) 
12.     collectgarbage("setstepmul", 5000) 
13.   
14.     local cclog = function(...) 
15.         print(string.format(...)) 
16.     end 
17.   
18.     require "hello2" 
19.     cclog("result is " .. myadd(3, 5)) 
20.   
21.     --------------- 
22.   
23.     -- create farm 
24.     local function createLayerFarm() 
25.         local layerFarm = CCLayer:create() 
26.   
27.         local font = CCLabelTTF:create("Himi 使用tolua++ binding自定义类", "Verdana-BoldItalic", 20) 
28.         font:setPosition(ccp(220,260)) 
29.         layerFarm:addChild(font) 
30.   
31.         local ms  = MySprite:createMS("Icon.png") 
32.         layerFarm:addChild(ms) 
33.   
34.         return layerFarm 
35.     end 
36.   
37.     -- run 
38.     local sceneGame = CCScene:create() 
39.     sceneGame:addChild(createLayerFarm()) 
40.     CCDirector:sharedDirector():runWithScene(sceneGame) 
41. end 
42.   
43. xpcall(main, __G__TRACKBACK__) 

运行截图如下：

OK，今天就到这，希望大家多多探讨，有问题请及时留言。