假如你可以使用和cocos2d相似的api來開發(fā)android上面的游戲，那豈不是更爽？這樣，你就可以毫不費勁地擴大你的游戲的市場份額（android的用戶數(shù)量巨大啊?。?/p>

好吧，確實存在這么一個游戲框架，她就是cocos2d-x！cocos2d-x采用c++把cocos2d的api重新移植了一遍，，除了一些語法細節(jié)上面的差異之外，你可以使用幾乎一樣的api來編寫游戲。正是由于它是c++寫的，所以可以跨多個平臺，從ios到android、windows、再到linux、bada等！

在這篇教程里面，你將學習到，如何使用cocos2d-x和c++來編寫一個能夠同時在ios和android設備上面跑的“HelloWorld”程序。

而且，過兩天，我會再出一篇教程，向大家展示一個具體的游戲例子---一個跨平臺的太空射擊游戲！

好了，帶上你的iPhone和Android設備，讓我們開始吧！

Hello,Cocos2D-X for iOS!

在繼續(xù)之前，確保你先下載最新版本的cocos2d-x。

隨便在你的硬盤的某個位置上面解壓就可以了。注意，這個解壓出來的文件夾的完整路徑名，我們之后會用一個統(tǒng)一的別名$COCOS2DX_HOME來指代。

現(xiàn)在，你已經(jīng)下載到源碼了，讓我們來安裝項目模板吧！你可以先cd到$COCOS2DX_HOME這個目錄（譯者：指你剛剛解壓縮代碼的存放路徑）下面去。在安裝模板之前，先退出Xcode，然后打開一個終端，并輸入下面的命令：

cd$COCOS2DX_HOME

sudo./install-templates-xcode.sh-u

注意:在上面所示的代碼中，你不能直接輸入$COCOS2DX_HOME，而要輸入實際的路徑。如果你直接輸入了$COCOS2DX_HOME是不會有任何反應的。當然，你可以參考我寫的《如何在macos下面配置集成ios和android游戲教程》，里面有講到環(huán)境變量的配置。大概方法就是打開～/.bash_profile文件，然后用export來定義環(huán)境變量就ok了。

你可能會被要求輸入管理員密碼（加了-u應該是不需要輸入密碼的，不加-u就需要輸入），之后的過程就非常簡單了。在模板安裝好之后，啟動xcode，然后創(chuàng)建一個新的項目。這時，你可以在項目模板對話框中看到有cocos2d-x的模板了。不用擔心，cocos2d-x的模板與cocos2d的模板并不會有沖突，因此，你還是可以創(chuàng)建cocos2d的項目。

讓我們來試一下新模板吧！打開Xcode，然后創(chuàng)建一個新的工程，選擇iOS\cocos2d-x\cocos2dx模板，如下圖所示：

把工程例句為Cocos2DxFirstIosSample，然后保存。

現(xiàn)在，編譯并運行，你將會看到cocos2d-x的hellowolrd程序跑起來了，如下圖所示：

非常簡單，不是嗎？這時，你可以看看xcode里面的文件，特別是Classes\HelloWorldScene.H和Classes\HelloWorldScene.cpp。如果你也熟悉cocos2d的話，那么里面的代碼看起來會覺得非常熟悉---幾乎完全一樣的cocos2dAPI，只是語言是c++而已！

配置cocos2d-x的eclipse開發(fā)環(huán)境

現(xiàn)在我們已經(jīng)完成了Xcode4的helloworld程序了，是時候看看如何使用eclipse來配置android的cocos2d-x開發(fā)環(huán)境了。

這篇教程假設你有一個可以進行Android開發(fā)的標準開發(fā)環(huán)境。如果你還沒有的話，可以參考這篇教程來配置，它里面提供了詳細的過程，教你如何一步步配置好一個標準的eclipseandroid開發(fā)環(huán)境。

但是，請等一下。一個標準的eclipseandroid開發(fā)環(huán)境是專為java開發(fā)設計的，而cocos2d-x卻是基于c++來做開發(fā)的！

不用擔心，eclipse已經(jīng)有10年的歷史了，它有許多插件可以支持其它語言的開發(fā)，這當然就包括c/C++語言的插件啦。先讓我們來安裝這個插件吧。打開eclipse，然后執(zhí)行以下步驟：

從EclipseIDE的主工具欄上面，選擇Help/InstallNewSoftware。

打開WorkWith復選框，并從中選擇一個包含你的eclipse版本名稱的項（如果是最新版的eclipse的話，就選擇indigo）

在插件樹里面找到ProgrammingLanguages(只有當你復選中“Groupitemsbycategory”時，你才可以看到插件樹。)并打開它.

選擇CDT插件，然后安裝下列組件。（但是，請注意，你如果直接就點擊C/C++DevelopmentTools的話，你是得不到下圖所示的樣子的，你還需要在“MobileDevelopment”里面去查找相關的項）（譯者：我沒找了，直接就選擇了C/C++DevelopmentTools就Next安裝了）

點擊next來完成向導，然后等待組件下載并安裝?，F(xiàn)在，你可以使用eclipse來開發(fā)C/C++項目了！

Set up the Android NDK(Native Development Toolkit)

本來，android開發(fā)只能采用java，而且現(xiàn)在市場上面大部分的app也是采用java寫的。

然而，現(xiàn)在你還可以通過NativeDevelopmentToolkit(NDK)，使用C/C++來編寫android程序。這種編程方式是由Google在2009年6月份引入的，它允許一些組件采用C/C++來編寫，然后通過標準的JavaNativeInterface(JNI)來調(diào)用。

安裝NDK的過程非常簡單：

下載最新版本的NDK。here(注意選擇MacOSX平臺).

解壓tar.bz2到任意目錄.之后，我會使用$NDKROOT來指定這個解壓縮后的目錄。

NDK給Android開發(fā)帶來了全套的C/C++編譯工具集，可以使用GCC4.4.3來編譯來鏈接并且可以構建即時安裝的APK包。

有了這套編譯工具集，我們就可以在eclipse里面集成一些外部的C/C++庫（比如cocos2d-x）。這些庫被編譯成動態(tài)庫，然后通過JNI(JavaNativeInterface)與JavaAndroid體系程序進行交互。

這些編譯工具集可以采用下面兩種方式使用:

獨立模式:直接在你的makefile中使用arm-linux-androideabi-g++.這種方式會增加你的項目的復雜性和可維護性。我推薦你不要使用這種方式。

集成模式：使用$NDKROOT/ndk-buildshell工具，它是一種高度可定制的makefile，專門為NDK庫所設計的。這也是我們這篇教程所采用的方式。

解釋JNI和NDK可能會花費大量時間，而且也超出了本教程的討論范圍?，F(xiàn)在網(wǎng)絡上有許多關于JNI的資源。這里還推薦一本書，它也討論了JNI這個主題。

如果你需要更多關于NDK的信息，這里推薦一本非常好的書，它里面涵蓋了使用C/C++進行NDK開發(fā)，書名是：AndroidNativeDevelopmentKitBeginner’sGuide。這本書覆蓋了NDK編程的方方面面，可謂是“從入門到精通”，而且NDK本身也帶有非常詳細的文檔，在$NDKROOT/docs路徑下面。

Hello,Cocos2D-X for Android!

現(xiàn)在，讓我們在Andriod平臺上面來開發(fā)一個“Hello，World”程序吧，就像我們之前在ios平臺上的程序一樣。

我們需要通過命令行來完成工作，因為目前還沒有在EclipseIDE里面集成cocos2d-x的模板。

在$COCOS2DX_HOME目錄下面包含一個shell腳本，叫做create-android-project.sh，我們可能通過它來創(chuàng)建android項目。但是，在運行腳本之前，我們需要在腳本文件的頂部做一些修改：

#setenvironmentparamters

NDK_ROOT_LOCAL="/home/laschweinski/android/android-ndk-r5"

ANDROID_SDK_ROOT_LOCAL="/home/laschweinski/android/android-sdk-linux_86"

修改上面這些行，把NDK_ROOT_LOCAL指向你安裝AndroidNDK($NDKROOT)的位置，同時把ANDROID_SDK_ROOT_LOCAL指向你安裝AndroidSDK位置。（譯者：這里其實可以不用修改，讀者可以打開這個sh腳本去看看為什么。如果之前看過我的配置教程，里面有配置一個全局的NDK_ROOT和ANDROID_SDK_ROOT。這個腳本在判斷有全局的環(huán)境變量存在的時候，會直接替代NDK_ROOT_LOCAL和ANDROID_SDK_ROOT_LOCAL。）

現(xiàn)在，可以運行create-android-project.sh腳本了，然后你會接收到一系列的提示輸入。我們將一個個向您解釋一下：

第一個提示要求你“Inputpackagepath”。這個包名會給后面的java代碼使用。你可以使用你的域名反過來寫，類似寫ios的bundleID。比如com.yourdomain.samplecocos2dxandroid，記住實際輸入的時候要替換掉“com.yourdomain”。

接下來，你會得到一系列可用的AndroidAPI和它們的id號。這個具體取決于你的機器上面安裝的AndriodAPI的情況。

最后，你需要提供項目的名稱，在這里取名為samplecocos2dxandroid：

命令行的輸出大致如下：

bash-$./create-android-project.sh

Inputpackagepath.Forexample:org.cocos2dx.example

org.jymc.samplecocos2dxandroid

...

AvailableAndroidtargets:

----------

...

----------

id:9or"GoogleInc.:GoogleAPIs:15"

Name:GoogleAPIs

Type:Add-On

Vendor:GoogleInc.

Revision:1

Description:Android+GoogleAPIs

BasedonAndroid4.0.3(APIlevel15)

...

inputtargetid:

9

inputyourprojectname:

samplecocos2dxandroid

Createdprojectdirectory:/Users/jymen/development/cocos2dx/samplecocos2dxandroid

...

Addedfile/Users/jymen/development/cocos2dx/samplecocos2dxandroid/AndroidManifest.xml

Addedfile/Users/jymen/development/cocos2dx/samplecocos2dxandroid/build.xml

Addedfile/Users/jymen/development/cocos2dx/samplecocos2dxandroid/proguard.cfg

bash-$

注意“Createdprojectdirectory:”這一行是腳本文件最后輸出來的，這個輸出的路徑也就是你的Andriod項目被創(chuàng)建好的路徑。我這里指的是/Users/jymen/development/cocos2dx/samplecocos2dxandroid，如上圖所示：

Note:Donottrytomovetheprojectfromthatlocationtoadifferentlocation.Atleastoneofthescriptswe’llworkwithinthenextsectionwillnotworkifyoudo.

構建工程

這里有兩個步驟來構建項目----首先通過命令行腳本編譯c++代碼，然后通過ecipse來編譯java代碼。

為了編譯c++代碼，我們需要切換到$PROJECT_HOME/android文件夾下面去，然后在終端里面輸入下列命令：

./build_native.sh

你應該會看到下面類似的輸出：

Gdbserver:[arm-linux-androideabi-4.4.3]libs/armeabi/gdbserver

Gdbsetup:libs/armeabi/gdb.setup

Compile++thumb:cocos2d<=CCConfiguration.cpp

Compile++thumb:cocos2d<=CCDrawingPrimitives.cpp

:

:

:

Compile++thumb:cocos2d<=CCTileMapAtlas.cpp

Compile++thumb:cocos2d<=CCTouchDispatcher.cpp

Compile++thumb:cocos2d<=CCTouchHandler.cpp

Prebuilt:libstlport_static.a<=/sources/cxx-stl/stlport/libs/armeabi/

SharedLibrary:libcocos2d.so

Install:libcocos2d.so=>libs/armeabi/libcocos2d.so

Compile++thumb:cocosdenshion<=SimpleAudioEngine.cpp

Compile++thumb:cocosdenshion<=SimpleAudioEngineJni.cpp

SharedLibrary:libcocosdenshion.so

Install:libcocosdenshion.so=>libs/armeabi/libcocosdenshion.so

Compile++thumb:game_logic<=AppDelegate.cpp

Compile++thumb:game_logic<=HelloWorldScene.cpp

SharedLibrary:libgame_logic.so

Install:libgame_logic.so=>libs/armeabi/libgame_logic.so

Compile++thumb:game<=main.cpp

SharedLibrary:libgame.so

Install:libgame.so=>libs/armeabi/libgame.so

這里就是在編譯cocos2d-x庫和你的項目里面的c++文件。

為了編譯java代碼，我們需要創(chuàng)建一個eclipse工程---這可比命令行要方便多了。：）

打開Eclipse，然后他吃軟飯File\New\Other，選擇Android\AndroidProject，然后點擊Next，在ProjectName里面輸入samplecocos2dxandroid，然后選擇Createprojectfromexistingsource，然后瀏覽到$PROJECT_HOME/android文件夾，如下圖所示：

點擊Next，選擇一個Androidversiontotarget（這里選擇的是3.2，你可以選擇任何一個）

點擊Finish，好了，現(xiàn)在你有一個工程了！

在左邊的樹上右擊項目，選擇RunAs\AndroidApplication，然后AVD(AndroidVirtualDevice)就會啟動，然后就會跑出來Hello,Cocos2D-X項目了！

注意：如果程序沒有啟動的話，你需要按照提示去創(chuàng)建一個AVD來測試。更多的細節(jié)，請參考GettingStartedwithAndroidDevelopment這篇教程。

恭喜你，你現(xiàn)在有一個“Hello，World”項目可以同時跑在ios和android上面了！

在Eclipse里面定義一個結合java/c++的工程

通過命令腳本來編譯c++代碼，完了之后用eclipse來編譯java代碼，這種來回切換的做法非常笨重。如果全部可以用eclipse來完成的話，那么生活會更簡單一些。

幸運的是，我們可以告訴eclipse，我們的android項目是一個集成java/c++的跨語言項目！

為此，我們在左邊的項目樹上選擇samplecocos2dxandroid，然后從菜單里面選擇File\New\Other，然后從對話框里面選擇C/C++\ConverttoaC/C++Project，如下所示：

點擊Next。在下一個屏幕里面，選中你的項目，然后選擇c++單選按鈕，然后為Projecttype指定Makefileproject\OtherToolchain，如下所示：

點擊完成。這時eclipse會詢問你是否打開C/C++視圖，當對話框出現(xiàn)的時候，選擇NO。

接下來的步驟就是修改項目設置，指定如何運行我們的make命令。在左邊的項目樹上，右擊samplecocos2dxandroid工程，選擇Properties，然后選擇C/C++build

取消“Usedefaultbuildcommand”復選框，然后在build文本框中輸入下面的命令：

bash${workspace_loc:/samplecocos2dxandroid}/build_native.shNDK_DEBUG=1V=1

點擊Apply，然后點OK。

回到ecipse，從主菜單中選擇Project\BuildAll，這時你可以在ecipse的控制臺輸出中看到c++make在運行。

我們?nèi)匀挥幸恍┚嫘枰鉀Q。想知道我是什么意思嗎，你打開jni/helloworld/main.cpp，這里你會看到一系列的警告，如下所示：

這些警告之所以會出現(xiàn)，是因為我們沒有配置正確的c++包含路徑。為了解決它，我們右擊samplecocos2dxandroid工程，然后選擇Properties\C/C++General\PathandSymbols\GNUC++。

選擇Add…按鈕來選擇下面的目錄，之后點擊Apply和OK。

$(NDKROOT)/platforms/android-9/arch-arm/usr/include

$(COCOS2DX_HOME)/cocos2dx/include

注意:不用忘了使用實際的路徑來替換掉$(NDKROOT)和$(COCOS2DX_HOME)。

點擊Apply，這時會提示你是否重建索引。直接點擊yes繼續(xù)就可以了。

現(xiàn)在，你再看看main.cpp，你會看到大部分警告已經(jīng)消失了。

但是，AppDelegate.h文件還是找不到。這是因為AppDelegate.h是在$PROJECT_HOME\Classes文件夾下面。這個文件夾對我們來說非常重要，因為它包含了我們工程里面的可移植的c++類，比如HelloWorldScene.cpp等。

當我們創(chuàng)建eclipse項目的時候，我們必須選擇$PROJECT_HOME\android文件夾，因為eclipse需要一個AndroidManifest.xml文件。但是，這樣的話，我們的工程就不包括關鍵的“Classes”文件夾了，這也是為什么我們會得到這么多警告的原因。

讓我們來修正它吧。右擊samplecocos2dxandroid項目，選擇Properties\C/C++General\PathsandSymbols\Sourcelocation。點擊LinkFolder，然后復選中Linktoafolderinthefilesystem，接著瀏覽到$PROJECT_HOME文件夾，并指向Classes目錄，最后點Apply和OK。

你現(xiàn)在可以在文件樹里面看到Classes目錄了，而且在main.cpp里面的#include“AppDelegate.h”警告也應該消失了。

Eclipse工程里面還會有許多警告，但是，這是因為eclipse對于解析c++頭文件的能力并不強大。為了消除這些警告，我們又需要設置一下項目設置。（右鍵點工程，然后選擇Properties），把CodeAnalysis部分的warnings關閉，如下圖所示：

然后點擊Apply和OK，這時，你就得到一個工程可以在eclipse里面進行編輯了。

What About the Java Code?

這時你在eclipse里面再找找看，你會在src和gen目錄下面找到一些java代碼，你肯定很好奇這些代碼是干嗎用的。

Andriod開發(fā)采用的主要語言是java，這個項目模板已經(jīng)為我們創(chuàng)建了一些java框架代碼，用來加載c++編寫好的動態(tài)庫。

一般情況下，你是不需要修改這些java代碼的，但是，還是讓我們來看看src\com\xxx\samplecosos2dxandroid\samplecocos2dandroid.java這個類。

這個類包含了主AndroidActivity類，當應用程序啟動的時候會加載。它首先通過NDK來請求編譯好的c++動態(tài)庫。（如果采用的是最新版的coocs2dx的話，下面只會加載一個game庫）

由于類是從Cocos2dxActivity所派生，在后臺cocos2d-x會把控制權移交給c++的AppDelegate的initInstance方法來處理，最后applicationDidFinishLAunching方法也就被執(zhí)行起來了。

因此，再重申一遍，java代碼只是一些包裝代碼，大部分情況下我們都不要去修改它，因為我們的游戲邏輯是由c++寫的。

Sotorepeat,theJavacodejustcontainswrappercodethatyouwillrarelyneedtochange,sinceallthegame’slogicwillbeinsidetheC++code.

連接andriod和ios項目結構

現(xiàn)在，我們有兩個cocos2d-x的項目了，一個是ios下面的，一個是andriod下面的。我們的目標是讓兩個工程共享同樣的目錄，這樣就可以使用同樣的c++文件了。

我們兩個項目里面，都有一個文件夾叫做“Classes”，它包含了我們的可移植的游戲代碼（如下圖：android的在左邊，ios的在右邊）

如果你仔細看看eclipse和xcode里面的Classes目錄，你會發(fā)現(xiàn)這些c++文件完全相等。因此，我們需要做的就是讓兩個項目指向同一個文件夾就ok了！

為了實現(xiàn)這個目標，在xcode里面打開Cocos2DxFirstIosSample項目。選擇Classes分組，然后點擊Delete，選擇“MovetoTrash”；

接下來，右鍵ProjectNavigator，選擇“NewGroup”，然后重命名為Classes。點鍵Classes，點擊AddFiles。然后選擇$PROJECT_HOME\Classes目錄，同時確保“Copyitemsintodestinationgroup’sfolder”沒有被選中！

然后clean并rebuildxcode項目，并運行一下，確保一切ok。

恭喜，現(xiàn)在基礎配置全部弄好了！你可以試著在eclipse里面修改，xcode這邊運行，或者xcode里面修改，eclipse里面運行了。

什么時候使用Xcode,什么時候使用Eclipse?

現(xiàn)在，你有兩個項目了，那么問題馬上就出來了，我們到底什么時候該使用哪一個呢？

使用cocos2d-x通常的開發(fā)策略是，首先在ios上面通過xcode來測試，確認沒問題后，再通過eclipse來測試。只需要在心里記住下面幾點就行：

經(jīng)常測試.開發(fā)完一個小功能之后，就應該在andriod上面測試看行不行。這樣的話，就不至于遇到問題找不到了。

在多個設備上面測試:現(xiàn)在市場上面有大量的android設備，而且它們的差別很細微，所以，你要盡可能多地測試多種不同型號的設備。

當然，你也可以先在andriod上面測試，然后再在ios上面測試。但是這樣肯定會降低你的生產(chǎn)率。因為xcode比eclipse反應速度更快，而ios模擬器比android的模擬器的啟動速度也要快一些。

調(diào)試技巧

在ios上面調(diào)試cocos2d-x和cocos2d的方法差不多，這里也沒什么多講的。

然而，對于Android，這里有幾點需要注意下。

當使用NDK來調(diào)試的時候，一個“服務端的”gdb和gdbcontext被ndk-buildshell腳本塞到APk里面去了。這個遠程的gdb調(diào)試器可以與任何gdb兼容的客戶端進行通信。

Eclipse里面最好的gdbagent就是NVidiadebugmanagerplugin，但是安裝這個插件不在本教程的討論范圍之內(nèi)。

注意:如果你想安裝NVidiaDebugManagerplugin,你首先到這個頁面下載完整的TegraAndroid開發(fā)包，即便你可能現(xiàn)在并不需要它。然后，安裝TegraDeveloper，它會提示你安裝哪些項，然后你可以選擇NVidiaDebugManagerplugin這個插件了。當你安裝完之后，它并沒有包插件安裝到eclipse里面去，而是把zip文件放在你的硬盤的某個位置，你可以參考這個pdf文檔來進行安裝。

我發(fā)現(xiàn)在一些物理設備（比如SamsumgGalaxyS），remotedebugger老是啟動不了，但是使用AVD就可以正常啟動。

為了啟動一個debug會話，你可以選擇你的項目，然后右擊DebugAsAndroidNDKapplication，如下圖所示：

請注意，只有你安裝了NVidiadebugmanagerplugin，你才會在右擊的時候看到AndroidNDKApplication這個選項。

你可以在一行代碼上面雙擊來設置一個斷點，如下所示：

當斷點到達的時候，它將會停留在斷點所在行：

悲催的是，使用gdb來調(diào)試android有時候并不管用，所以，你可能需要添加一些額外的tracing系統(tǒng)。想知道更多的信息，請聯(lián)系我，我將與大家分享這些tips。

何去何從?

恭喜你，你現(xiàn)在可以使用cocos2d-x來開發(fā)iphone和android下面的游戲了。

請耐心等待我的第二篇教程吧，它將帶你一起開發(fā)一個跨平臺的太空射擊游戲，當然是使用cocos2d-x啦！

原文鏈接地址：http://www.raywenderlich.com/11283/cocos2d-x-for-ios-and-android-getting-started