Cocos2d-x 3.x 全平臺(Android,iOS)新手開發配置教程攻略

本身寫的博客：http://blog.sina.com.cn/s/blog_732d16630101g445.html

之前只作過網頁遊戲（《古今東西》，www.ooplay.net），遊戲也曾經開發過Android的手機版本，但本身寫的引擎，固然也不能跨平臺。所謂「工欲善其事，必先利其器」，使用成熟的引擎固然要銳利得多，因此果斷投入了Cocos2d-x的陣營。我搗鼓了幾天，才把平臺上的東西配置好，如今買的書和網上的攻略大都是介紹2.x的，對於佈置3.0開發平臺的內容幾乎都是網上的，但都是這裏一點，那裏一點。

因此我把本身的搗鼓經歷記錄下來，但願對你們有所幫助。由於這篇文章是面對新手的。因此有些地方會囉嗦一些。請勿見怪。由於本人也是新手，若是教程中有錯誤，歡迎指正。若是在配置開發平臺時還遇到問題，請在評論中留言，我會盡力解答。

我使用的環境是本身的PC（Win7）+HTC G18。還有從朋友那裏借來的MacBook Air+Mini iPad。

1、通用準備工做

一、安裝Cocos2d-x3.1。
在Cocos的主頁上：http://cocos2d-x.org/
這個不用解釋了。下載後解壓縮就行。

二、安裝Eclipse與AndroidSDK。
這個在Mac上或是PC上開發都是能夠通用的。
Eclipse在官網：http://www.eclipse.org/
Android SDK在Android開發者中心：http://developer.android.com
Eclipse是開發Android須要用到的IDE。這是個很牛X的IDE，有許多插件讓他變得三頭六臂。要開發Android的程序，須要下載相關的插件，但若是每一個插件要本身配置，會是很蛋痛的事情。若是是新手，推薦使用：ADTBundle。這是Eclipse+Android SDK的合體，全部的項目都已經幫你配置好了。

三、安裝JDK：
Eclipse須要Java環境才能運行。若是事先沒有安裝Java環境，則會報錯。
解決方案安裝jdk：http://www.oracle.com/technetwork/java/javase/downloads/index.html
通常來講安裝以後會自動配置好環境變量。若是尚未解決問題，請查找網絡上關於JDK安裝的攻略。不少的。

四、安裝CDT插件
地址：http://www.eclipse.org/cdt/downloads.php
這是個Eclipse的插件，用來支持Eclipse中C/C++語言的開發。從Eclipse的官網下載，下載以後，將features和plusins這兩個文件夾裏面的內容複製到Ecplise安裝目錄下對應的文件夾以後就能夠了。

五、安裝NDK
地址：http://developer.android.com/tools/sdk/ndk/index.html
這是進行C/C++與Java混合編譯的必要工具。記下下載以後解壓到的目錄，由於到以後的安裝中會用到。

六、安裝ANT
地址：http://ant.apache.org/
這個是用來幹什麼的我至今還不明白。但聽說Cocos的Android開發須要用到它，其它的攻略上都說須要，因此下載下來安裝好吧。



2、PC環境下配置過程

一、安裝VS2012。
地址：網上不少，在官方下載也行。
最好是2012，我曾經試過2010，2013，都會出這樣那樣的問題。因此，2012！

二、安裝python2.7.6
地址：https://www.python.org/download/releases/2.7.6/
由於Cocos2d-x的安裝程序是用phthon寫的，因此須要這個軟件。不要下載python3.0以上的版本，不然運行會出錯。若是是Mac，那麼天生就自帶了。

三、進行開發環境配置
以上的工做完成以後，就能夠進行配置了。啓動Windows的命令行（CMD）工具。進入Cocos2d-x3.1的安裝目錄，執行：
python setup.py
Cocos2d-x3.1版本使用這個setup.py來安裝，十分方便。執行以後會讓你配置上面準備工做中所安裝的：ANT、NDK、SDK等目錄，把安裝到哪兒去了填寫進入就行。

四、創建本身的項目
用setup.py配置好Cocos2d-x的環境以後，你的命令行中就會多如「cocos」的命令，新建項目將使用這個命令進行。示例：
cocos new hello（項目名稱）-p com.hello（包名字）-l cpp（項目類型） -dE:\MyCocos\cocos2d（目錄）
新建的項目會把全部的源文件和庫都拷到你的項目目錄中。因此新建的項目文件會很大，有許多人懷疑這個的必要性，不過到你以後的開發中就會知道這種配置方法是對的了。

項目創建好以後，就能夠開發了：

A、進行VS2012的開發。
找到你的項目目錄下的：proj.win32，打開裏面的解決方案就行。剩下的就是你的任務了。通常來講，直接就能夠運行。

B、進行Android的開發。
使用Eclipse中的項目導入，導入proj.android中的項目方案。導入以後，由於SDK的問題，通常沒法啓動，關於這個問題，以及其它的問題，請參見（4、其它問題解決方案）


3、MAC環境下配置過程

一、註冊蘋果開發者帳號。
地址：http://developer.apple.com/iphone/index.action
若是不使用真機，使用模擬器調試，那麼有開發者帳號應該就足夠了。
若是要使用真機調試，須要購買IOS開發者會員，688RMB一年。我看到以前的攻略說要99美圓，可是看如今的頁面的的提示，應該只要有網銀就能夠支付了。網上的攻略寫得很是複雜，說要下載證書什麼什麼的，如今通通都不須要了，XCode所有爲您代勞了，只要照提示一路點贊成就行。

一、安裝XCode
在你的開發者首頁下面就有XCode的下載。經過App Store下載安裝便可。
請使用最新的XCode（須要OS X 10.8以上系統支持），並使用App Store安裝。個人MacBookAir從朋友那裏拿來時仍是10.7，由於下載老是中斷，多次不成功，因此用XCode 4.6，但好像不經過AppStore安裝會出這樣那樣的問題。因此強烈推薦使用最新的版本。

三、進行開發者環境配置。
與PC的配置同樣，打開MAC的終端程序，執行setup.py，配置好各類SDK的路徑就行。但MAC須要再加上一句：
source /Users/yourname/.bash_profile
這是用來刷新配置文件的。

四、創建項目文件
也與PC的項目同樣。使用命令行創建。
若是你像我同樣用兩個平臺（PC與MAC）開發，能夠共享同一個項目目錄。個人項目文件是放在PC上的，MAC經過共享訪問項目文件。

項目創建好以後就能夠開發了。MAC下的配置相對簡單，使用XCode打開項目目錄下的proj.ios_mac下的項目配置文件就行。以後基本不會出錯的。



4、其它問題解決方案

Eclipse與Android相關：

問題：SDK錯誤
由於Cocos2d-x的模版默認是使用Android 2.3.3（API-10)，若是新安裝的ADT Bundle或AndroidSDK，是API-19，則會出現錯誤，解決方案是經過Android SDK中的管理工具（SDK Manager）下載Android2.3.3的SDK。

問題：Project 'XXX' is missing required source folder: 'gen'
這個問題就是上面的SDK錯誤致使的。

問題：undefined reference to'cocos2d::network::HttpClient::getInstance()'
我是使用網絡庫(network)的時候出現這個錯誤的。若是你使用其它庫，解決方案是同樣的。緣由是缺乏庫的引用。解決方案是在Android.mk裏面增長：
LOCAL_WHOLE_STATIC_LIBRARIES += cocos_network_static
Cocos2d-x的開發者已經在Android.mk裏面加上了不少這種路徑，平時是註釋掉的。您要使用時把這些增長上去就行。

問題：fatal error: cocos-ext.h: No such file or directory
問題分析：缺乏頭文件路徑的引用
須要在：Android.mk裏面增長
LOCAL_C_INCLUDES += $(LOCAL_PATH)/../../cocos2d/extensions
Cocos2d-x的開發者已經在Android.mk裏面加上了不少這種路徑，平時是註釋掉的。您要使用時把這些增長上去就行。

問題：The import org.cocos2dx.lib cannot be resolved。
沒法找到指定的庫文件。解決的方案是增長路徑的引用：Project Properties -> Java Build Path-> Source and then linking「項目目錄/cocos/platform/android/java/src」


VS2012相關：

問題：「extensions/ExtensionMacros.h」: No such file or directory
沒法打開包括文件。
一、解決方案中，添加「現有項目」--> libExtensions 具體目錄： ..\cocos2d\extensions\proj.win32\libExtensions.vcxproj
二、項目中添加引用-->libExtensions
三、經過：屬性->C/C++->附加包含目錄。附加包含目錄：$(EngineRoot)
若是你使用其它的文件，解決方案是同樣的。一、增長項目的引用。二、附加頭文件的包含目錄。


XCode相關：

問題：Contacting Your Reference
由於我最初註冊的AppleID和開發者帳號的名字不同，因此支付了開發者會員以後，沒法驗證經過。出現這個提示。解決的辦法是聯繫蘋果開發者客服：400 6701855。客服會幫你確認身份，解決這個問題。


其它攻略文章：
若是有不清楚的地方，能夠參考如下攻略文章，基本上我也是靠這些文章來解決問題的：
如何聯機調試和發佈iOS程序
Eclipse 運行 cocos2d-x-3 項目終極方案
Cocos2d-x 3.0正式版及android環境搭建詳細教程
Cocos2d-x 3.0rc，又一種建立項目方式
引用extension時（包括髮布到Android平臺）遇到的問題
[url=hthttp://logger.iteye.com/blog/911977]android中The connection to adb isdown，問題和解決[/url]