cocos2d-xWin32Android環(huán)境配置手冊

1、COCOS2D-X配置手冊(Win32、Android)編制：劉勤熙李育完成日期：2012-1-19目錄1.引言.32.cocos2d-x Win32環(huán)境酉己置.32.1 Win32開發(fā)環(huán)境配置 .32.1.1 Visual Studio 2008 . 32.1.2 cocos2d-x. 32.1.3（可選）Visual Assist X. 32.1.4（可選）doxygen. 42.2 Win32可執(zhí)行文件生成過程 .52.3常見問題總匯.73cocos2d-x Android環(huán)境酉己置.83.1 android開發(fā)環(huán)境酉己置 .83.1.1 Eclipse 3.7.1. 83.1.2 Ec

2、lipse ADT插件.83.1.3 Eclipse CDT插件.103.1.4 AndroidSDK. 123.1.5 AndroidNDK. 133.1.6 Cygwin . 133.2 Android可執(zhí)行文件生成過程 .153.2.1前期準備.153.2.2生成Android空工程 .153.2.3交叉編譯so文件 .153.2.4生成android系統(tǒng)可用的apk文件.163.3常見問題匯總 .184其它.181.引言略,，一切需要的軟件及插件版本號以筆者使用為準，其它版本號的軟件及插件不保證有效。文件下載地址在2012-1-19確認有效，不保證因各種原因?qū)е孪螺d地址失效。開發(fā)平臺操

3、作系統(tǒng)為Win32 （WindowsXP、WindowsVista、Windows?）2. cocos2d-x Win32環(huán)境配置2.1 Win32開發(fā)環(huán)境配置2.1.1 Visual Studio 2008安裝VisualStudio2008，默認安裝即可，如果是自定義安裝，VisualC+組件應(yīng)選中。2.1.2 cocos2d-x1.下載cocos2d-x引擎最新版官方下載地址為:http:/code.google.eom/p/cocos2d-x/downloads/list（當前使用版本為cocos2d-1.0.1-x-0.10.0.zip）2.將cocos2d-1.0.1-x-0.10

4、.0.zip解壓縮至硬盤任意目錄（建議D:Work7cocos2d-1.0.1-x-0.10.0,因為現(xiàn)在wophone勺開發(fā)環(huán)境必須安裝至此，以 下以此為例）3.如果想查看引擎源代碼，可以在.cocos2dxproj.win32目錄下找到代碼配置文件。2.1.3（可選）Visual Assist X用來提高VisualStudio2008的工作效率，可以安裝此工具。安裝支持VS2008版本的任意一版，無需配置。本軟件是收費軟件，需要注冊。技巧：如果不想讓VAX對注釋中的拼寫進行校正（即去掉單詞下面的波浪線提示），可以選擇Visual Assist X Option ,進行如下配置： Visu

5、al Assist X Options確定取消I應(yīng)用也）LJ2.1.4（可選）doxygen安裝工具doxygen Win32版本（本例用，本工具為開源軟件）運行doxygen,選擇file-open找到D:Work7cocos2d-L0.1-x-0.10.0doxygen目錄下的doxygen.cocos2d-x文件，并打開（此文件為cocos2d-x代碼的doxygen配置文檔）Quick Config-AdvaiicedFmtw and ClrsLiztboxesSuggest! onsUnderlines- Correcti oixsRefactoring Genera

6、lDisplay3 Projects Performancei- Startup System Info!-AboutUnderlinesSettingsWhole Tnmato SoftwareOJnderlin.fi Epelling errors in conmeiiLtE gd strings usingMiilibu. : ii. .in. .in 1 i s iii .iMCi n. .ii. uinII&- Kiiiii.& & : siM iiiiums iiiiuiiMPV UziderLiae niistyped synbol using虹dW Do

7、xygen GUI frontend (D:/Wo rk7/coo s2 d - IrO. 1 -x-OrlO ,0/doxygen/doxygen ,cocc s2d-x)File Settings HelpStep 1 : Speci y th vorking directory F選項-項目和解決方案-VC+目錄在包含文件欄，加入下列項目D:Work7cocos2d-L0.1-x-0.10.0Box2DD:Work7cocos2d-1.0.1-x-0.10.0CocosDenshionincludeD:Work7cocos2d-1.0.1-x-0.10.0cocos2dxplatform

8、third_partywin32OGLESD:Work7cocos2d-1.0.1-x-0.10.0cocos2dxplatformwin32 D:Work7cocos2d-1.0.1-x-0.10.0cocos2dxplatformD:Work7cocos2d-1.0.1-x-0.10.0cocos2dxincludeD:Work7cocos2d-1.0.1-x-0.10.0cocos2dxD:Work7cocos2d-1.0.1-x-0.10.0D:Work7cocos2d-1.0.1-x-0.10.0chipmunkincludechipmunkD:Work7cocos2d-1.0.1-

9、x-0.10.0cocos2dxplatformthird_partywin32（上面紅色部分第一個是重力引擎，第二個應(yīng)該是個網(wǎng)絡(luò)連接的東西）在庫文件欄，加入D:Work7cocos2d-1.0.1-x-0.10.0Debug.win32（引用的是該目錄下的所有Lib文件）（發(fā)布時用release目錄下的！!）6.點擊VS9 IDE的啟動調(diào)試按鈕，正常情況可以編譯通過，并顯示helloworld頁面看到這個頁面，表示win32環(huán)境配置成功.2.3常見問題總匯1.錯誤：error PRJ0019:某個工具從以下位置返回了錯誤代碼”（及類似錯誤）引用了一個$#$#.處理：include設(shè)置有誤.d

10、ll沒有放在正確位置2.錯誤：LNK1000: Internal error during IncrBuildImage.上一個增量鏈接沒有生成它；正在執(zhí)行完全鏈接.處理：這是微軟的一個漏洞，下載KB948127#丁，安裝即可.胃如果不能正常安裝,也可以把VS舛的增量編譯關(guān)掉:項目名處點右鍵,依次選擇-屬性- 配置屬性- 鏈接器- 常規(guī)- 啟用增量鏈接（否） 以后再遇上此類問題，可以嘗試再次編譯或者清理后重新生成.3.錯誤：.error LNK2019:無法解析的外部符號.處理：lib沒有添加依賴工程 點右鍵-屬性-配置屬性-鏈接器-輸入 附加依賴項 填入以下lib文件libcocos2d.l

11、ib libgles_cm.lib libBox2d.lib libchipmunk.lib libcurl_imp.lib libCocosDenshion.liblibjpeg.lib libpng.lib liblua.lib libxml2.lib libEGL.lib libzlib.liblibzlib.lib libiconv.libpthreadVCE2.lib（根據(jù)實際使用情況填寫）3 cocos2d-x Android環(huán)境配置3.1 android開發(fā)環(huán)境配置Android開發(fā)需要用到JDK,做程序的都知道，3.1.1 Eclipse 3.7.1下載地址:http:/www

12、./downloads/packages/eclipse-classic-371/indigosr1選擇對應(yīng)的連接進行下載（32位操作系統(tǒng)或64位操作系統(tǒng)）eclipse為全綠色開發(fā)工具，直接解壓縮后即可使用。3.1.2 Eclipse ADT插件該插件是Eclipse平臺下用來開發(fā)Android應(yīng)用程序的插件。打開eclipse3.7.1選擇Help- Software Updates,在Work with欄填入https:/dl- Project證明ADT更新成功Nev ProjcctSelect a wizardWizards：世Java Project驟 Java

13、 Froject from Existing Ant Buildfile Flug-in ProjectGeneral回AniroiA 卜登Androi d $splw PrejectJHAndroi d Tst Project 日 CVS Lz JwaLz Fingin DfivelopmentEx amplaEfinish3.1.3 Eclipse CDT插件安裝CDT插件的目的為令eclipse可以識別由C/C+開發(fā)的代碼，對其進行編譯。CDT可以從/cdt/downloads.php下載到，對應(yīng)eclipse3.7.1的CDT插件 版本為CDT

14、8.0.1。下載完成后，啟動eclipse,選擇Help- Software Updates，點擊ADD按鈕選擇archive,選擇下載好的CDT插件zip文件(cdt-master-8.0.1.zip)然后OK確認，勾選全部安裝項目， 點擊next按鈕eclipse會開始安裝。同樣，在安裝過程中有一次同意軟件協(xié)議選項的勾選。idroi d Fr eject完成后eclipse會要求重啟軟件，OK即可。重啟eclipse后選擇New-Projec會發(fā)現(xiàn)eclipse已經(jīng)支持C/C+項目。3.1.4 AndroidSDKAndroid SDK可以從http:/ ,還需要運行SDK Manager

15、.exe進行SDK包下載。筆者沒有下載最新的SDK，是通過r10版本的SDK Manager進行更新的。將r10版本的SDK Manager.exe更新至r15,即可看到新發(fā)布的SDK包。更新過程中筆者碰到了一個目錄 被占用的錯誤，解決辦法為：打開androidSDK所在路徑的temp文件夾將tools_r15-windows.zip解壓縮，將tools_r15-windows中的tools文件夾覆蓋至androidSDK根 目錄，選擇“No”即可，選擇需要的包進行下載安裝（2.1、2.2、2.3版本的SDK包均有更新）。.Android SDK lanagerF ackageEToolsSD

16、K P ath：| Dgwnltdinf Andreid SDK Tool酎rtviiion 16 (36%, 200 KiB/t, 9Z stondi3.1.5 AndroidNDK使用NDK的目的為將C/C+編寫的代碼生成能在arm上運行的*.so文件。由android的java代碼來調(diào)用。AndroidNDK可以從http:/ 下載，截止2012-1-19最新版本為r7。3.1.6 CygwinCygwin為Linux模擬環(huán)境，因使用NDK生成本地*.so本地庫需要用到交叉編譯環(huán)境，而交叉編譯需要在linux系統(tǒng)下才能完成。Cygwin可以從http:/ ,兼PX/TOf打 偏Hpmla

17、 NW Inr.W中乩t jus tailed噂.1.2 by 5叫y品赤三鄧町蜘仙州囪1%砒，10btJJIStaUeaF| 蜂 &華丑AfTs iy曰臼JJIF.w JbtJJIStailed1密 尬WmliPk by的BroJa曹PMI瑚JZne.1GJJIJ禰Mj f * jSffffprfljfa頃Jjsr.禰齡 X版齡輜切說Jj?r.拒口讖APIAL ty JTptprpJ* Jifpt/jJi (x Inf?.10.險tJJi s t再S7G62 by iJfptpj-pJa WPEZIJ.切Znc10JJIStaJIecf-， Android 2 3.1 (API 9)

18、 A Sples for SDKg1f! Installedhdii Android 2.2 (API 6)7中SDK Flatfcirma2/ Updatertv. 3 & Stapl+3 for SDK81| 藏.而以SFJ-FMAFTSBy JiTOCERA rpjypj-Bfjpns，壓E jjif 每R.&13P Ar誠ff/JVPtJns taJIef禰6ALAZf 7M皈Saws img- ?FC-J-MJrs.ejjisaJJeJSort by： jKPI jievelj C .1Rfeposi toryLns t *11 5 psShflw ； E Vditi

19、s/N*- Q InitdLltdl I lObslitii Seli-ct or LfedtA I回岡pelele 5 packages.Iksalget. All包為：1.binutils組件lewB.S. Si rePackageA金 Skip響426k auto4nakelr7: (1.7) a tool for 專卷 Skip響500kautofliakeL 6: (1.8) a tool for【1回 Skipnfa558kant 碩 alL： (1.9) a tool for OSkiprV響142kbaEhdb: Debugger for bash EcrijO20060B11

20、lrL區(qū) 1 4f815k binutils： The GNU assembler, 1會 Skip- rV 響294k bison： A p 邸戲 r generstftr that響 nfa4T245k Boost： Portable C+ libraries t4 Skip飾 nfa 2f600k boost-devtl: Port tbit C+ libr? v1HI|直|OSkip2.gcc組件442k make： Tlie GNU ver si of the make-1utility安裝完成后，運行Cygwin.bat，輸入make -v3.2 Android可執(zhí)行文件生成過程3

21、.2.1前期準備1.代碼文件：*.h及*.cpp注意代碼文件中不能含有unicode編碼，必須使用ascii碼。2.資源文件：工程使用的資源3.2.2生成Android空工程1.進入cocos2d-x目錄，找到create-android-project.bat文件，使用UE等編輯工具打開進行編輯，修改如下項目：1)cygwin目錄找到set _CYGBIN=在等號后面填入本機cygwin/bin目錄，如：C:cygwinbin2)NewB-S.Si zePackage-prJFSJ.pOSkipnfall,72TkE.巳p lg單7 心 yJL* r AUlll1X VI 5kipnfcaI

22、kgcc-mingw： Ming32 4gdb組件施 wBS.SizePackage4II w1gc Gm i ngw-j avm m i 鞏 gw-j suppQrT切 kipnfa56k gcc-m i ng*-obj c: Hi ngw32 suppor t打 Skiprtfa1,511kgcc-ctjc ObjC compilerQSkipnfaL 58lkgec-teslEtiits： GCC tetsuis020050706-2區(qū)3,958kgdb Ths GWV Debugger切 kipnfaITBk gettet： GWV Internationeli:iti伊 kipnfa

23、L ST2kgettewt-dev&l： GNU InternetionwOSipnfa2, 193kgi t： Fast Version Cntrcl SysUv3.82.90-1和gcc -v如果能找的，則表示安裝成功3. gcc-mingw組件5. make組件找到set _ANDROIDTOOLS=在等號后面填入本機Android/tools目錄，如：D:Androidandroid-sdk-windowstools3)AndroidNDK目錄找到set _NDKROOT=在等號后面填入本機NDK目錄，如：D:Androidandroid-ndk-r7修改完成后保存關(guān)閉。2.進

24、入cocos2d-x目錄中的cocos2dx目錄，找到Android.mk文件，使用UE等編輯工具得開進行編輯，編輯此文件的目的為使用cocos2d支持NDKr7版本。在文件的最末尾處找到LOCAL_CFLAGS := -DUSE_FILE32API,將其修改為LOCAL_CFLAGS := -DUSE_FILE32API -DGL_GLEXT_PROTOTYPES=1,保存關(guān)閉。3.運行cocos2d-x下的create-android-profect.bat文件，首先輸入項目生成目錄，至少是雙層目錄，如：com.MyGame?；剀嚭髸筝斎牍こ堂?，最好和目錄名一致，如：MyGame?；剀?/p>

25、后會要求選擇AndroidSDK的版本號，一般選擇2.1以上版本，相應(yīng)id是4回車后會在cocos2d-x目錄中生成一個工程目錄，工程目錄中含有android、Classes、Resource三個子 目錄。3.2.3交叉編譯so文件1.將準備好的代碼文件拷貝到工程下的Classes目錄；資源文件拷貝到工程下的Resource目錄。打開Classes目錄找到Android.mk，使用編輯工具打開， 在LOCAL_SRC_FILES :=填入要編譯的cpp文件，保存后關(guān)閉。如：LOCAL_SRC_FILES := AppDelegate.cpp GameOverScene.cpp Joystick.cpp TerribleGameScene.cpp2.打開cygwin ,輸入工程路徑下的Android文件夾 的完整路徑，如：cd d:/makeapk/MyGame/Android。然后運行build_native.sh文件，具體輸入 為：./build_native.sh3.編譯過程中，如果有錯誤發(fā)生請參考后章節(jié)的排錯方法進行解決。4.補充一點，每次打開cygwin并輸入完整路徑是很麻煩的事情，可以通過下面的方法自 動執(zhí)行一些命令：用