手把手教你swift项目添加cocos2dx-lua

本文所用各版本信息:
Xcode9.2 + swift4版本
cocos2d-x v3.17 中文官方网站

集成思路

首先网上给出一个C系的思路,本人未亲测,并且以C调用lua,绕过了cocos2d-x的调用思路,不觉得这种方式很好,所以弃之;

C语言调用思路

本文思路如图:
swift->objective-c->c++->lua
首先swift与objective-c的互相调用非常方便,其次oc只需要将.m文件写成.mm就可以在实现中直接调用c++方法,并且c++可以直接绑定lua,这样一来,就实现了,ios系语言写主框架,lua写游戏逻辑,直接通过ViewController展现就可以了;并且lua脚本可以像资源添加的方式直接在文件夹中替换,非常方便;基于以上思路,说干就干;

首先你需要一个swift项目

新建一个swift语言写的工程,我们默认你已经会用Xcode做这件事了,于是,工程的结构先大致看一下;

Nothing项目结构

image_1cf2g61423hj8ks12ngn544ov1g.png-122.4kB

这里是我自己的swift工程,上面的是总结构,下面的是内部工程结构,我们这里只关注一下bridge,首先创建一个CocosViewController的控制器,这里的控制器可以是OC类型的,也可以使用swift类型的(由于我们需要用OC做桥接文件,所以需要我们创建一个OC的类,我这里自己写了一个单例用来做桥接,所以控制器就无所谓是OC还是swift了),用来呈现我们用cocos2dx-lua展现的游戏页面;在swift工程中添加OC文件会自动生成桥接文件,名字如图;另外还需要注意一点,CocosViewController的.m文件要修改成.mm类型,这样就可以在实现中直接调用C++的类了;

创建好后先不要动,我们再来创建一个OC类型的单例,用来进行引擎的初始化操作,以及对lua游戏操作进行封装,我自己命名为LuaBridge
image_1cf2h2kvq7381eho18ieh5v1s5o1t.png-12kB

#import "LuaBridge.h"
#include "CocosLua.hpp"

@interface LuaBridge()
{
    CocosLua _cocosLua;
}

@end

@implementation LuaBridge

- (instancetype)init
{
    self = [super init];
    if (self) {
        _cocosLua = CocosLua();

    }
    return self;
}

static LuaBridge* _bridge = nil;

+ (instancetype)shared {
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        _bridge = [[LuaBridge alloc] init];
    });
    return _bridge;
}
@end

上面出现的CocosLua是一个c++的类,在工程中自己创建的;创建它的目的是用来封装cocos2dx-lua的操作,这个类直接被隐藏在LuaBridge单例中,在实际应用过程中可能用的不是很多,我们这里出现它只是为了说明本文的类型结构;

#ifndef CocosLua_hpp
#define CocosLua_hpp

#include <iostream>

class CocosLua {

public:
    CocosLua();
    ~CocosLua();

public:
    void cocos_lua();
};

#endif /* CocosLua_hpp */

创建一个cocos2dx-lua项目

首先我们需要去cocos官网上下载cocos2dx源码,链接在本文开始,我自己下载的是v3.17版本,下载的是zip包,解压后如下图:

image_1cf2mkgfu1m1uk0i13ppv7jieh3h.png-77.4kB

接下来打开终端,我们创建一个lua项目;

image_1cf2mm4hr2387mi1snp1iv51gtb3u.png-82.5kB

一路cd到我们下载的cocos2dx文件夹下,然后:

$ cd tools/cocos2d-console/bin/

到上面的这个目录下新建工程,使用下面的命令格式:

cocos new <game name> -p <package identifier> -l <language> -d <location>
<game name> 工程名
<package identifier> 包名,bundle id
<language> 所用语言 cpp lua js
<location> 项目创建路径
$ ./cocos new Nothing-lua -p com.charles.nothing -l lua -d /Users/dizi/Desktop

image_1cf2n16id1lfp13phripbgh13ta4b.png-153.7kB

image_1cf2n2esh15vo18se12q01i7dih54o.png-29kB

整合swift项目与lua项目

如果你做到这一步,那么我们离成功不远了;接下来我们要把lua项目里的资源拷贝到swift项目中,具体跟着我一步一步做;

  1. 把lua项目下frameworks/cocos2d-x文件夹拖动到swift目录下:
    image_1cf2ni2nnkpq1pmrsbd1iippri55.png-160.2kB
    这里说一点,如果工程是用git管理,因为cocos2d-x下文件比较多,而且是cocos2dx代码文件,所以不必要上传,可添加.gitignore文件:
    image_1cf2o45re1ahs1lvjn8mca14be5i.png-16.3kB

  2. 把lua项目下frameworks/runtime-src/Classes文件夹拖动到swift目录下:
    image_1cf2o6cm9rhe1tj416tl1acf8285v.png-197.8kB

  3. 在swift项目目录下新建Resources文件夹,将lua项目中的如图三项拷贝进该文件夹下,这样以后lua的所有资源则将全部在该目录下替换,不需要修改工程中其他地方:
    image_1cf2obieh1vrtujma7ucml86d6c.png-112.3kB

  4. 将刚刚添加的文件引用到工程项目中:
    image_1cf2ogs2gai2rj01e701jks1q2h79.png-75.4kB
    image_1cf2pbtk51lrv1kek18me1i5brlh8j.png-68.5kB
    注意我们的coco2d-x目录并不需要一并引入到工程中,我们不会用到它(不引用它并不说不会用到,不要删掉,不要删掉,不要删掉!!!);
    PS:这里注意蓝色文件夹和黄色文件夹的区别;

工程环境配置

接下来到了重头戏,工程环境配置,这个部分我们需要耐心一点,因为有很多路径需要我们自己去找,还要搞清楚几个不同的工程项目配置,我们一步一步来;

  1. 引入工程文件,这几个工程文件分别生成cocos-lib以及调拭用.a库,以下依次:
    image_1cf2vge2nmebc02hcgk8k1a199g.png-241.5kB
    image_1cf2vjknh14co12bq15jqahuh0a9t.png-103.2kB
    image_1cf2vl0kf1skll42p86qi11k16aa.png-156.1kB

  2. 接下来配置资源库,点击工程TARGETS->Build Phases,在Target Dependencies中添加:
    image_1cf2vs1jffgj8avof61vg11iuaan.png-85.6kB
    在Link Binary With Libraries中添加如下支持库,其中lib文件需要打开Add other添加,按shift + command + G,在其中输入/usr/lib
    image_1cf304l9cja61nu71r9h1l8b539b4.png-118.7kB
    image_1cf309lts1b921oan4rhvkd1svebh.png-110.7kB

  3. cocos2dx不支持bitcode,在buildsetting中Enable Bitcode改为NO;
    image_1cf30d889rs6173d8s411e0i5jbu.png-21.7kB
    C++编译器部分:
    image_1cf30ekpb1omd1rj61m56qo1eracb.png-26.4kB

  4. Header Search Paths中添加:

$(inherited)
$(PROJECT_DIR)/cocos2d-x/cocos
$(PROJECT_DIR)/cocos2d-x/external/lua/tolua
$(PROJECT_DIR)/cocos2d-x/external/lua/lua
$(PROJECT_DIR)/cocos2d-x/external/lua
$(PROJECT_DIR)/cocos2d-x/external
$(PROJECT_DIR)/cocos2d-x/Classes

image_1cf30m5opf41hq513ib1eekflbco.png-130.9kB
5. 引入工程配置:
cocos2d_libs.xcodeproj工程配置中,确保以下架构都支持;
image_1cf30qh2sddp1mi95kj89o1725d5.png-52.8kB
cocos2d_lua_bindings.xcodeproj工程配置中,确保以下支持平台为iOS;
image_1cf30sk2o1211j4t88f11lt172dff.png-98.9kB
6. 好了,开始编译你的工程吧!

去倒杯水吧,这个过程会很久。。。

image_1cf31g68atfq3l31v3uf4n1nm6fs.png-8.4kB
Congratulations! 至此,工程已经全部配置完毕,你已经解决一个大Boss了;
今天就到这里吧,之后我们再续如何用swift调用lua 手把手教你swift项目添加cocos2dx-lua(2)

相关文章
相关标签/搜索