一、Windows开发环境配置
1、Visual Studio安装
Cocos2D-x支持Visual Studio的版本包括VS2008、VS2008 Express、VS2010和VS2012。本文选择VS2010作为开发环境,同时配合Visual Assist X。
2、Cocos2D-x安装与配置
(1)从Cocos2D-x官网(http://www.cocos2d-x.org/)下载最新版本的Cocos2D-x(cocos2d-2.1rc0-x-2.1.3)。
(2)解压文件到指定目录下。
(3)双击运行目录下的install-templates-msvc.bat文件进行安装。
(4)双击对应开发工具的sln文件,VS2010对应的是cocos2d-win32.vc2010.sln文件,打开文件的同时也启动了相应的VS开发环境。
(5)编译运行自带的HelloCpp项目来验证Cocos2D-x的安装是否正确。右键单击选中HelloCpp项目,设置为启动项。
(6)单击Build按钮,构建Cocos2D-x项目,也可以单击Debug按钮,调试运行HelloCpp项目,效果如下图所示。
图1 HelloCpp效果图
Cocos2D-x每个版本的工程目录会有所变化, cocos2d-2.1rc0-x-2.1.3的目录如下图所示:
图2 Cocos2D-x工程目录
(1)project-common(公共部分)
libBox2D:物理引擎Box2D
libchipmunk:物理引擎Chipmunk
libcocos2d:引擎核心
libCocosDenshion:声音
libExtensions:扩展
(2)project-cpp(C++测试工程)
(3)project-js(JavaScript测试工程)
(4)project-lua(Lua测试工程)
4、新建项目及交叉编译
新建项目的过程与新建VC项目的工程类似,不同的是选择Cocos-2d-x项目类型-->Cocos2d-win32 Application,在工程向导中可以选择使用的物理引擎、是否使用Cocos Denshion音乐模块、是否支持Lua脚本等,编译运行即可。
二、Android开发环境配置
Android是Google推出的开源手机操作系统,早期以Java语言作为第三方应用的开发语言,直到2009年6月,发布了NDK(Native Develop Kit,原生态本地开发包),支持开发者使用C/C++语言开发Android应用程序。Android的开发环境至少需要Eclipse、Android SDK和NDK来支持C/C++应用开发。
1、Cocos2D-x软件安装与配置
(1)JDK:JDK(Java Development Kit )是Java开发工具,点击 这里 下载 。
(2)Eclipse:支持Java和Android开发的开源集成开发工具,点击 这里下载,建议下载 C++版Eclipse,这样就不用安装CDT插件了。Eclipse是绿色版,解压后即可使用。
(3)ADT:ADT(Android Development Tools,Android开发插件)Android开发的Eclipse插件。
使用Eclipse在线安装方式安装ADT:启动Eclipse,选择Help-->Install New Software,在Work with栏中输入网址http://dl-ssl.google.com/android/eclipse,单击add按钮提取安装包列表,选择全部(开发工具和NDK插件),单击next-->next,选择accept licenses,单击finsh,开始安装,安装过程会比较长,请耐心等候。
(4)CDT:CDT(C++ Development Tools,C++开发插件)C++开发的Eclipse插件。
直接安装Eclipse的C++版本,则跳过此步。下载地址为http://wiki.eclipse.org/CDT/User/DownloadCDTLatest,下载压缩包后,同样选择Help-->Install New Software,弹出相应界面后Add本地的CDT地址,即可安装。
附注:(3)和(4)代表两种安装方式,这两种方式也适用于ADT的安装。
(5)Android SDK:Android开发工具,包括模拟器等。
安装完ADT后,会弹出提示框让安装Android SDK,按照提示进行即可。
也可以手动下载,地址为http://developer.android.com/sdk/index.html,下载完后解压到某个目录下,选择Windows-->Preferences-->Android,在SDK Location中选择或输入Android SDK地址,单击Apply-->OK,完成Android SDK配置。
找到刚才解压的目录,双击启动SDK Manager,选择安装Android的其它版本或相应工具。
(6)Android NDK:Android原生态本地开发包,辅助SDK进行编译开发,支持C/C++。
手动下载Android NDK,地址为 http://developer.android.com/tools/sdk/ndk/index.html。将NDK解压到某个目录下,选择Windows-->Preferences-->Android-->NDK,在NDK Location中输入NDK的地址,单击Apply-->OK,完成Android NDK配置。
(7)Cygwin:在Windows平台上运行的UNIX模拟环境,是Cygnus Solutions公司开发的自由软件。
Android NDK从r7开始,可以在编译时省去Cgywin。
(8)编译并运行 HelloCpp项目。
(A)选择File-->New-->Project,在弹出的对话框中选择Android Project from Existing Code,选择项目路径cocos2d-2.1rc0-x-2.1.3\samples\Cpp\HelloCpp\proj.android,点击Finish完成项目加载。右键单击项目HelloCpp,选择Properties-->Builder-->New,在弹出的对话框中单击OK,在弹出的对话框中选择Main选项卡,然后分别单击Browse File System和Browse Workspace,分别选择ndk-build.cmd和项目路径,具体如下图:
图3 NDK配置
(C)Cocos2D-x 2.0以上版本还需要设置NDK_MODULE_PATH环境变量,填写Cocos2D-x库路径和第三方库路径,中间用分号分隔,规则同Windows环境变量,在上图3中点击Environment选项卡,点击New,在Name中输入 NDK_MODULE_PATH,在Value中输入E:\android\cocos2d-2.1rc0-x-2.1.3;E:\android\cocos2d-2.1rc0-x-2.1.3\cocos2dx\platform\third_party\android\prebuilt,然后一路单击OK即可。也可以编辑当前项目的jni文件夹下的Application.mk文件,在末尾添加上 NDK_MODULE_PATH:=E:\android\cocos2d-2.1rc0-x-2.1.3;E:\android\cocos2d-2.1rc0-x-2.1.3\cocos2dx\platform\third_party\android\prebuilt即可。需要注意的是,路径中不能含有空格符,Windows用分号/Linux用冒号做分隔符。
(D)将NDK目录E:\android\android-ndk-r8e\sources\cxx-stl\gnu-libstdc++\4.7\libs\armeabi下的libgnustl_static.a文件复制到项目文件夹下E:\android\cocos2d-2.1rc0-x-2.1.3\samples\Cpp\HelloCpp\proj.android\obj\local\armeabi,之后右键项目选择runas-->Android Application运行,如果不出意外会出现如下warning:
Android NDK: WARNING: APP_PLATFORM android-14 is larger than android:minSdkV
可以忽略之,不过觉得看着不爽,也可以如下解决之:
打开E:\android\android-ndk-r8e\build\core\add-application.mk,将第128行的__ndk_warning改为__ndk_info即可,但是后遗症是不再提示warning。
(E)配置好后,选择Project-->Clean,再选择Project-->Build,开始编译项目,则下面控制台会输出:
Install : libhellocpp.so => libs/armeabi/libhellocpp.so
编译成功。
需要注意的是:所有组件的安装,包括cocos2d-x最好都放在非中文且目录无空格的路径下,否则会出现下面所示一类的错误:
Android NDK: Please define the NDK_PROJECT_PATH variable to point to it.
2、Cocos2D-x工程目录
Cocos2D-x工程目录主要包括如下内容:
(1)src:工程目录下会有几个带有src的文件夹,分别包含各自的源文件,包括入口类Activity、处理声音和加速度传感器的类等。
(2)gen:自动生成的的R.java文件、BuildConfig.java文件等。
(3)assets:资源文件。
(4)bin:APK包文件等配置文件。
(5)jni:包括编译时使用的MK文件等。
(6)libs:库文件(.so文件)。
(7)obj:目标文件,包括.so、.o等文件。
(8)res:XML等配置文件。
3、新建项目及交叉编译
新建项目需要用到Cygwin,具体步骤如下:
(1)安装Cygwin。从官网上下载并安装之,下载地址在 这里。
(2)修改Cocos2D-x目录下的create-android-project.bat文件中Cygwin、Android SDK和Android NDK目录的位置:
:: modify it to work under your environment
set _CYGBIN=C:\cygwin\bin
if not exist "%_CYGBIN%" echo Couldn't find Cygwin at "%_CYGBIN%" & pause & exit 4
:: modify it to work under your environment
set _ANDROIDTOOLS=C:\Users\ourgame\android-sdks\tools
if not exist "%_ANDROIDTOOLS%" echo Couldn't find android sdk tools at "%_ANDROIDTOOLS%" & pause & exit 5
:: modify it to work under your environment
set _NDKROOT=E:\android\android-ndk-r8e
if not exist "%_NDKROOT%" echo Couldn't find ndk at "%_NDKROOT%" & pause & exit 6
(3)双击执行create-android-project.bat文件,在命令行模式下输入项目路径和名称、SDK版本等,选择target id。
(4)编译运行项目,就能在E:\android\cocos2d-2.1rc0-x-2.1.3\samples\Cpp\HelloCpp\proj.android\bin目录下,看到HelloCpp.apk包了。
三、iOS开发环境配置
iOS是苹果公司开发的手持设备操作系统,最早发布于2007年1月9日的Macworld大会上,最初是为iPhone设计的,后来陆续支持iPod Touch、iPad以及Apple TV等苹果移动设备。iOS以Darwin为基础属于类UNIX系统,原名为iPhone OS,2010年6月7日WWDC大会上改名为iOS。
Xcode是苹果公司向开发人员提供的集成开发环境,类似于微软的VS,用于开发Mac OS应用程序。iOS SDK是iOS系统的开发工具,只要安装了Mac OS X Snow Leopard 10.6.2以上版本Mac OS操作系统,即可安装iOS SDK,可以使用iPhone模拟器进行调试或者使用真机进行调试。
在iOS上开发基于Cocos2D-x的应用程序也需要使用Xcode,点击这里下载安装文件,下载前需要注册苹果开发者,如果链接不好使也可以点击这里下载,下载后通过共享文件的方式将安装文件上传到虚拟机上(如何共享参看这篇拙文《iOS之PC与MAC虚拟机之间的文件传输》),双击DMG文件进行安装即可。
1、Cocos2D-x安装与配置
(1)将Cocos2D-x压缩包解压到某个目录下,便可以运行HelloWorld项目了。
(2)双击sample/Cpp/HelloCpp/proj.ios目录下的iOS工程文件(HelloCpp.xcodeproj),用Xcode打开HelloWorld项目,单击Run即可在iPhone模拟器和iPad模拟器上运行了,效果如下图所示:
图4 iPhone模拟器
sudo ./install-templates-xcode.sh
2、Cocos2D-x工程目录
Cocos2D-x工程目录如下图所示:
图5Cocos2D-x工程目录
Frameworks:引擎所使用的框架部分。
ios:iOS平台相关专用类。
Products:编译生成的包文件。
Resources:资源文件夹。
3、新建项目及交叉编译
(1)选择File-->New-->Project,弹出工程设置向导对话框,选择cocos2d-x,选择框架类型cocos2dx,点击next。
(2)输入产品名称world,Company Identifier(mancini),点击next。
(3)选择工程目录,点击create,创建工程,默认工程目录在桌面上。
(4)选择相应的模拟器,点击run,编译运行项目,效果图同图3。
四、用Doxygen生成Cocos2D-x文档
Doxygen是一种开源跨平台的工具,其功能是从源码中抽取类、方法、成员的注释,形成一个和源码配套的API帮助文档。Doxygen支持C、C++、Java、Objective-C等语言。Doxygen可以根据代码中的注释,按照规则生成相应的文档。Cocos2D-x代码依照其规则,并且提供了doxygen.cocos2d-x文件,这是Cocos2D-x代码的Doxygen配置文档,可以通过这个文件生成Cocos2D-x文档。
点击 这里下载Doxygen,根据需求选择版本下载,这里下载Windows安装版,安装完成后,启动Doxygen,选择File-->Open打开Cocos2D-x目录下的dosygen目录下的doxygen.cocos2d-x文件,选择Run选项卡,单击Run doxygen,运行并生成文档,Cocos2D-x\doxygen\html目录下的index.html文件即为Cocos2D-x文档。