自定義路徑創建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”。

我入手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/目錄下）使用方法比較簡單：

注意：

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目錄下面一樣可以鏈接到。

 #!/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)