自定义路径创建Cocos2d-x项目

自定义路径创建Cocos2d-x项目

本文介绍windows下面如何优雅的创建Cocos2d-x项目。为何称之为优雅，是因为现在网上流传的一些创建方法有一些问题。大致内容如下：

l  使用VS向导创建Cocos2d-x项目（废弃，不建议使用）

l  使用create_project.py

n  问题1：工程名等替换不完全

n  问题2：创建项目不能指定路径

使用VS向导创建Cocos2d-x项目（废弃，不建议使用）

在Cocos2d-x 2.1.3及之前，官方使用“install-template-msvc.bat”文件，安装VS创建Cocos2d-x项目向导，然后可以按照向导创建Cocos2d-x项目。注意：默认情况下，新建项目的存放的位置应该设置在Cocos2d-x引擎的安装目录下面，否则可能因为找不到库文件而不能通过编译。不过可以在设置项目属性，头文件和库文件的搜索路径来解决。可以参考我之前的一篇博文《C++静态库与动态库》，里面介绍如何设置vs项目属性使用静态库和动态库。

在Cocos2d-x 2.1.4，官方建议使用“create_project.py”来创建Cocos2d-x项目，并将在版本废弃了“install-template-msvc.bat”。

“We recommend you use multi-platform creating tools named create_project.py, which lies in tools/project-creator, to create a new project. This tool can create a project has the same folder structure as HelloCpp. Other tools such as create-android-project.sh will be removed in future.

Note: VS template was deprecated in this release, please use 'tools/project-creator' instead.”

——来自官网：http://goo.gl/yVAjMr

我入手Cocos2d-x的时候，刚发布Cocos2d-x 2.1.4，就被这个坑了。Cocos2d-x 2.1.4废弃了“install-template-msvc.bat”，但是下载压缩包里面又有，可恶的是不能用的，各种报错。同时网上流传的就是使用这种方法，让我绕了不少路。

使用create_project.py

create_project.py（cocos2d-x/tools/project-creator/目录下）使用方法比较简单：

Usage: create_project.py -project PROJECT_NAME -package PACKAGE_NAME -language PROGRAMING_LANGUAGE

Options:

 【-project   PROJECT_NAME】Project name, for example: MyGame

 【-package   PACKAGE_NAME】Package name, for example: com.MyCompany.MyAwesomeGame

 【-language  PROGRAMING_LANGUAGE】Major programing lanauge you want to used, should be [cpp | lua | javascript]

Sample 1: ./create_project.py -project MyGame -package com.MyCompany.AwesomeGame

Sample 2: ./create_project.py -project MyGame -package com.MyCompany.AwesomeGame –language javascript

注意：

l  官方建议python使用2.7.3

l  安装python之后需要设置环境变量，或者使用该脚本时指定python路径，如C:\python27\python.exe create_project.py …

使用该方法创建项目之后，项目位于cocos2d-x/projects目录下面。windows平台进入proj.win32，打开工程文件即可。

使用create_project.py创建项目的原理，即简单地将cocos2d-x\template目录下的三种语言模板multi-platform-cpp、multi-platform-lua、multi-platform-js复制到对应的新建工程目录下，然后用PROJECT_NAME、PACKAGE_NAME替换模板中的HelloCpp/ HelloLua/ HelloJavascript。

问题1：工程名等替换不完全

下面是我用towergame做为工程名创建的lua项目，目录如下：

虽然可以正常编译，但发现工程名未替换为towergame，这比较坑爹。一位日本开发者lettas已经有人提交了修复请求https://github.com/cocos2d/cocos2d-x/pull/3943，不过正式发布的版本中还没有修改。急着用可以去github checkout下来用。

问题2：创建项目不能指定路径

使用create_project.py不能自定义路径，必须放在cocos2d-x/projects目录下面，这个设定我认为非常不合理！这样将自己的项目放到cocos2d-x引擎目录中，不方便管理，即库与项目耦合到一起了，如果cocos2d-x升级也不方便。

比较合理的方案是：

l  cocos2d-x独立安装，这样对cocos2d-x升级也相对简单。

l  新建cocos2d-x项目独立于cocos2d-x安装路径。通过设置搜索或引用路径，让项目能够找到cocos2d-x安装路径。

幸运的是，完全可以做到这样。熟悉VS的同学应该知道，VS工程设置是支持环境变量的。通过下面的一些改造，可以让新建的cocos2d-x项目独立于cocos2d-x引擎目录：

1)     将通过create_project.py创建的项目剪切到你希望放置的目录；

2)     创建环境变量COCOS2DX_HOME，指向cocos2d-x安装目录；

3)     将*.sln文件使用文本方式打开，将里面的所有相对路径“..\..\..”都替换为环境变量%COCOS2DX_HOME%，如“..\..\..\cocos2dx\proj.win32\cocos2d.vcxproj”替换为“%COCOS2DX_HOME%\cocos2dx\proj.win32\cocos2d.vcxproj”；

4)     将*.vcxproj文件使用文本方式打开，将里面debug、release 2种模式下<AdditionalIncludeDirectories>节点定义的引用路径中包含”$(ProjectDir)..\..\..\”都替换为环境变量“$(COCOS2DX_HOME)\”；注意这里使用环境变量的方式与*.sln中不一样，是$(COCOS2DX_HOME)而非%COCOS2DX_HOME%。

至此，大工告成！看下面的运行起来的vs工程：

图中依赖的工程跟将新建的项目放在cocos2d-x/projects目录下面一样可以链接到。

上面的替换工作可以用文本的查找替换功能，可以轻松搞定。但是为了能够与create_project.py集成，我提供下面一段代码能够自动替换.sln、.vcxproj文件中对于内容：

 #!/usr/bin/python   

#-*- encoding:utf-8 -*-   

import sys, os

def checkOption():
    argLen = len(sys.argv)
    targetPath = "./"
    if argLen == 2:
        targetPath = sys.argv[1]
        if not targetPath.endswith("/"):
            targetPath += "/"
    return targetPath
    
def replaceCocos2dxPath(path):
    filelists = os.listdir(path)
    for item in filelists:
        suffix = (os.path.splitext(item))[1]
        print(suffix)
        if suffix == ".sln":
            print('replace "..\..\..\" with %COCOS2DX_HOME% in *.sln')
            #replace "..\..\..\" with %COCOS2DX_HOME% in *.sln 
            content = open(path + item, 'r').read().replace("..\\..\\..\\", "%COCOS2DX_HOME%\\")
            file = open(path + item, 'w')
            file.write(content)
            file.close()
        if suffix == ".vcxproj":
            print('replace "$(ProjectDir)..\..\..\" with $(COCOS2DX_HOME)\ in *.vcxproj')
            #replace "$(ProjectDir)..\..\..\" with $(COCOS2DX_HOME)\ in *.vcxproj
            content = open(path + item, 'r').read().replace("$(ProjectDir)..\\..\\..\\", "$(COCOS2DX_HOME)\\")
            file = open(path + item, 'w')
            file.write(content)
            file.close()

if  __name__ == '__main__':
    targetPath = checkOption()
    replaceCocos2dxPath(targetPath)