一、通用準(zhǔn)備工作

1、安裝Cocos2d-x 3.1

在Cocos2d官網(wǎng)上下載 Cocos2d-x 3.2+引擎 ，下載后解壓縮。

2、安裝Eclipse與Android SDK

這個(gè)在Mac上或是PC上開(kāi)發(fā)都是可以通用的。

Eclipse 在其官網(wǎng)下載（ 官網(wǎng)地址 ）。

Android SDK 在Android開(kāi)發(fā)者中心下載（ 地址 ）。

Eclipse是開(kāi)發(fā)Android需要用到的IDE。這是個(gè)很牛的IDE，有許多插件讓他變得三頭六臂。要開(kāi)發(fā)Android的程序，需要下載相關(guān)的插件，但如果每個(gè)插件要自己配置，會(huì)是很蛋痛的事情。

如果是新手，推薦使用：ADT Bundle。這是Eclipse+Android SDK的合體，所有的項(xiàng)目都已經(jīng)幫你配置好了。

3、安裝JDK

Eclipse需要Java環(huán)境才能運(yùn)行。如果事先沒(méi)有安裝Java環(huán)境，則會(huì)報(bào)錯(cuò)。

解決方案安裝jdk（ 下載地址 ）。

一般來(lái)說(shuō)安裝之后會(huì)自動(dòng)配置好環(huán)境變量。如果還沒(méi)有解決問(wèn)題，請(qǐng)查找網(wǎng)絡(luò)上關(guān)于JDK安裝的攻略，很多的。

4、安裝CDT插件 （ 下載地址 ）

這是個(gè)Eclipse的插件，用來(lái)支持Eclipse中C/C++語(yǔ)言的開(kāi)發(fā)。

從Eclipse的官網(wǎng)下載，下載之后，將features和plusins這兩個(gè)文件夾里面的內(nèi)容復(fù)制到Ecplise安裝目錄下對(duì)應(yīng)的文件夾之后就可以了。

5、安裝NDK （ 下載地址 ）

這是進(jìn)行C/C++與Java混合編譯的必要工具。記下下載之后解壓到的目錄，因?yàn)榈街蟮陌惭b中會(huì)用到。

6、安裝ANT （ 下載地址 ）

Cocos的Android開(kāi)發(fā)需要用到它，所以下載下來(lái)安裝好吧。

二、PC環(huán)境下配置過(guò)程

1、安裝VS2012 （ 官方地址 ）

網(wǎng)上還有很多其他下載地址。

最好是2012，我曾經(jīng)試過(guò)2010，2013，都會(huì)出這樣那樣的問(wèn)題。所以，2012！

2、安裝python 2.7.6 （ 下載地址 ）

因?yàn)镃ocos2d-x的安裝程序是用phthon寫的，所以需要這個(gè)軟件。不要下載python3.0以上的版本，否則運(yùn)行會(huì)出錯(cuò)。如果是Mac，那么天生就自帶了。

3、進(jìn)行開(kāi)發(fā)環(huán)境配置

以上的工作完成之后，就可以進(jìn)行配置了。啟動(dòng)Windows的命令行（CMD）工具。進(jìn)入Cocos2d-x 3.1的安裝目錄，執(zhí)行：

python setup.py
Cocos2d-x 3.1版本使用這個(gè)setup.py來(lái)安裝，十分方便。執(zhí)行之后會(huì)讓你配置上面準(zhǔn)備工作中所安裝的：ANT、NDK、SDK等目錄，把安裝到哪兒去了填寫進(jìn)入就行。

4、建立自己的項(xiàng)目

用setup.py配置好Cocos2d-x的環(huán)境之后，你的命令行中就會(huì)多如“cocos”的命令，新建項(xiàng)目將使用這個(gè)命令進(jìn)行。示例：

cocos new hello（項(xiàng)目名稱）-p com.hello（包名字）-l cpp（項(xiàng)目類型） -d E:\MyCocos\cocos2d（目錄）
新建的項(xiàng)目會(huì)把所有的源文件和庫(kù)都拷到你的項(xiàng)目目錄中。所以新建的項(xiàng)目文件會(huì)很大，有許多人懷疑這個(gè)的必要性，不過(guò)到你之后的開(kāi)發(fā)中就會(huì)知道這種配置方法是對(duì)的了。

項(xiàng)目建立好之后，就可以開(kāi)發(fā)了：

A、進(jìn)行VS2012的開(kāi)發(fā)。

找到你的項(xiàng)目目錄下的：proj.win32，打開(kāi)里面的解決方案就行。剩下的就是你的任務(wù)了。一般來(lái)說(shuō)，直接就可以運(yùn)行。

B、進(jìn)行Android的開(kāi)發(fā)。

使用Eclipse中的項(xiàng)目導(dǎo)入，導(dǎo)入proj.android中的項(xiàng)目方案。導(dǎo)入之后，因?yàn)镾DK的問(wèn)題，一般無(wú)法啟動(dòng)，關(guān)于這個(gè)問(wèn)題，以及其它的問(wèn)題，請(qǐng)參見(jiàn)（四、其它問(wèn)題解決方案）。

三、MAC環(huán)境下配置過(guò)程

1、注冊(cè)蘋果開(kāi)發(fā)者賬號(hào) （ 注冊(cè)地址 ）

如果不使用真機(jī)，使用模擬器調(diào)試，那么有開(kāi)發(fā)者賬號(hào)應(yīng)該就足夠了。

如果要使用真機(jī)調(diào)試，需要購(gòu)買IOS開(kāi)發(fā)者會(huì)員，688RMB一年。我看到之前的攻略說(shuō)要99美元，但是看現(xiàn)在的頁(yè)面的的提示，應(yīng)該只要有網(wǎng)銀就可以支付了。網(wǎng)上的攻略寫得非常復(fù)雜，說(shuō)要下載證書什么什么的，現(xiàn)在統(tǒng)統(tǒng)都不需要了，XCode全部為您代勞了，只要照提示一路點(diǎn)同意就行。

2、安裝XCode

在你的開(kāi)發(fā)者首頁(yè)下面就有XCode的下載。通過(guò)App Store下載安裝即可。

請(qǐng)使用最新的XCode（需要OS X 10.8以上系統(tǒng)支持），并使用App Store安裝。我的MacBook Air從朋友那里拿來(lái)時(shí)還是10.7，因?yàn)橄螺d總是中斷，屢次不成功，所以用XCode 4.6，但好像不通過(guò)App Store安裝會(huì)出這樣那樣的問(wèn)題。所以強(qiáng)烈推薦使用最新的版本。

3、進(jìn)行開(kāi)發(fā)者環(huán)境配置。

與PC的配置一樣，打開(kāi)MAC的終端程序，執(zhí)行setup.py，配置好各種SDK的路徑就行。但MAC需要再加上一句：

source /Users/yourname/.bash_profile
這是用來(lái)刷新配置文件的。

4、建立項(xiàng)目文件

使用命令行建立。

如果你像我一樣用兩個(gè)平臺(tái)（PC與MAC）開(kāi)發(fā)，可以共享同一個(gè)項(xiàng)目目錄。我的項(xiàng)目文件是放在PC上的，MAC通過(guò)共享訪問(wèn)項(xiàng)目文件。

項(xiàng)目建立好之后就可以開(kāi)發(fā)了。MAC下的配置相對(duì)簡(jiǎn)單，使用XCode打開(kāi)項(xiàng)目目錄下的proj.ios_mac下的項(xiàng)目配置文件就行。之后基本不會(huì)出錯(cuò)的。

四、其它問(wèn)題解決方案

Eclipse與Android相關(guān)：

問(wèn)題 ：SDK錯(cuò)誤

因?yàn)镃ocos2d-x的模版默認(rèn)是使用Android 2.3.3（API-10)，如果新安裝的ADT Bundle或Android SDK，是API-19，則會(huì)出現(xiàn)錯(cuò)誤，解決方案是通過(guò)Android SDK中的管理工具（SDK Manager）下載Android 2.3.3的SDK。

問(wèn)題 ：Project 'XXX' is missing required source folder: 'gen'

這個(gè)問(wèn)題就是上面的SDK錯(cuò)誤導(dǎo)致的。

問(wèn)題 ：undefined reference to 'cocos2d::network::HttpClient::getInstance()'

我是使用網(wǎng)絡(luò)庫(kù)(network)的時(shí)候出現(xiàn)這個(gè)錯(cuò)誤的。如果你使用其它庫(kù)，解決方案是一樣的。原因是缺少庫(kù)的引用。解決方案是在Android.mk里面增加：

LOCAL_WHOLE_STATIC_LIBRARIES += cocos_network_static

Cocos2d-x的開(kāi)發(fā)者已經(jīng)在Android.mk里面加上了很多這種路徑，平時(shí)是注釋掉的。您要使用時(shí)把這些增加上去就行。

問(wèn)題 ：fatal error: cocos-ext.h: No such file or directory

問(wèn)題分析：缺少頭文件路徑的引用

需要在：Android.mk里面增加

LOCAL_C_INCLUDES += $(LOCAL_PATH)/../../cocos2d/extensions

Cocos2d-x的開(kāi)發(fā)者已經(jīng)在Android.mk里面加上了很多這種路徑，平時(shí)是注釋掉的。您要使用時(shí)把這些增加上去就行。

問(wèn)題 ：The import org.cocos2dx.lib cannot be resolved。

無(wú)法找到指定的庫(kù)文件。解決的方案是增加路徑的引用：Project Properties -> Java Build Path -> Source and then linking “項(xiàng)目目錄/cocos/platform/android/java/src”

VS2012相關(guān)：

問(wèn)題 ：“extensions/ExtensionMacros.h”: No such file or directory

無(wú)法打開(kāi)包括文件。

1、解決方案中，添加“現(xiàn)有項(xiàng)目”--> libExtensions 具體目錄： ..\cocos2d\extensions\proj.win32\libExtensions.vcxproj

2、項(xiàng)目中添加引用-->libExtensions

3、通過(guò)：屬性->C/C++->附加包含目錄。附加包含目錄：$(EngineRoot)

如果你使用其它的文件，解決方案是一樣的。1、增加項(xiàng)目的引用。2、附加頭文件的包含目錄。

當(dāng)遇到COCOS2DX 3.2+版本創(chuàng)建權(quán)限問(wèn)題時(shí):

首先，打開(kāi)終端cd到目錄 /cocos2d-x-3.2/tools/cocos2d-console/bin 下, 運(yùn)行 cocos.py 腳本創(chuàng)建文件。

[javascript] view plaincopy

./cocos.py new HelloWorldDemo -p com.coco2dx.org -l cpp -d ~/Desktop
參數(shù)說(shuō)明：

HelloWorldDemo為項(xiàng)目名稱

-p 后面接包名

-l 后面接開(kāi)發(fā)語(yǔ)言類型，有cpp, lua, js三種類型

-d 后面接項(xiàng)目存放的目錄

如果出現(xiàn) -bash: ./cocos.py: Permission denied ，是因?yàn)闆](méi)有權(quán)限。 用命令 chmod 修改一下目錄下的 cocos.py 權(quán)限就可以了

[cpp] view plaincopy

chmod u+x cocos.py