安装工具
1. 配置JDK
- JDK下载地址:
本人的系统是Win7 64位版,但安装的是JDK7,Windows X86版。如果安装文件夹在: C:\Program Files (x86)\Java\jdk1.7.0_21;当然也能够是其它地方
- 环境变量设置:
JAVA_HOME=C:\Program Files (x86)\Java\jdk1.7.0_21CLASSPATH=.;%JAVA_HOME%\lib;Path添加 %JAVA_HOME%\bin;本文如果你知道怎么环境变量设置,如果不知道,请使用搜索引擎查找相关资料,设置完后打开cmd,输入java -version假设出现以下提示,表明设置环境变量成功:C:\Users\arlin>java -versionjava version "1.7.0_21"Java(TM) SE Runtime Environment (build 1.7.0_21-b11)Java HotSpot(TM) Client VM (build 23.21-b01, mixed mode, sharing)
2. 下载Android SDK
Google为Android开发人员提供了ADT(Android Developer Tools),里面包括了SDK和Eclipse。
下载地址是:能够选择32位或64位版本号,我选择的是32位版的,把它解压到一个文件夹,我这里是: d:\adt-bundle-windows-x86\,文件夹结构例如以下:--<adt-bundle-windows-x86>--<eclipse>--<sdk>--SDK Manager.exe
3. 下载Android NDK
下载地址是:相同有32位和64位版可选,我选择的是32位版的,把它解压到adt同文件夹下,如今adt的文件夹结构例如以下:--<adt-bundle-windows-x86>--<eclipse>--<sdk>--< android-ndk-r8e>--SDK Manager.exe
4. 下载ANT
ANT是为了自己主动构建Android程序用。下载地址是:我选择的是: apache-ant-1.9.3-bin.zip,相同解压到adt文件夹下,如今adt的文件夹结构例如以下:--<adt-bundle-windows-x86>--<eclipse>--<sdk>--< android-ndk-r8e>--<apache-ant-1.9.3>--SDK Manager.exe
5. 下载Python
- 原来cocos2dx在不同平台下必须用不同的脚本来创建和构建project,3.0以后都统一用python了,所以Windows下须要安装python环境:
下载地址:
原来下载了最新的版本号,使用setup.py的时候发现有语法错误,所以最好使用2.7.3版本号,亲測过没有问题
- 配置环境变量:最新版本号能够自己主动加进path环境变量,但2.7.3不行,所以我们仅仅能自己设置一下,如果我的Python安装在:d:\Python27\
把这个路径加到path环境变量中, 当我们在cmd下输入python,出现以下字样,就说明设置环境变量正确了:C:\Users\arlin>pythonPython 2.7.3 (default, Apr 10 2012, 23:31:26) [MSC v.1500 32 bit (Intel)] on win32Type "help", "copyright", "credits" or "license" for more information.>>>
cocos2d-x下载与配置
1. 下载cocos2d-x
眼下最新版本号是3.0RC,下载地址是:下载完解压到一个地方,我这里: f:\cocos2dx\cocos2d-x-3.0rc0\
2. 环境变量设置
cc须要以下几个环境变量,用于后面的新建project,构建project等:
- COCOS_CONSOLE_ROOT: cocos控制台路径,控制台用于新建,构建,发行project。
- NDK_ROOT: NDK根文件夹
- ANDROID_SDK_ROOT: SDK根文件夹
- ANT_ROOT: ANT根文件夹
这几个环境变量是通过cocos2d-x根文件夹下的setup.py来配置的,我们启动cmd,执行setup.py:F:\cocos2dx\cocos2d-x-3.0rc0>setup.py此时脚本须要我们提供NDK,SDK,ANT的路径,我们依据之前放的路径输入就是了,整个命令步骤例如以下:Setting up cocos2d-x...-> Adding COCOS2D_CONSOLE_ROOT environment variable... OK-> Added: COCOS_CONSOLE_ROOT = F:\cocos2dx\cocos2d-x-3.0rc0\tools/cocos2d-console/bin-> Looking for NDK_ROOT envrironment variable... NOT FOUNDPlease enter its path (or press Enter to skip): d:\adt-bundle-windows-x86\android-ndk-r8eADDED-- Added: NDK_ROOT = d:\adt-bundle-windows-x86\android-ndk-r8e-> Looking for ANDROID_SDK_ROOT envrironment variable... NOT FOUNDPlease enter its path (or press Enter to skip): D:\adt-bundle-windows-x86\sdkADDED-> Added: ANDROID_SDK_ROOT = D:\adt-bundle-windows-x86\sdk-> Looking for ANT_ROOT envrironment variable... NOT FOUNDPlease enter its path (or press Enter to skip): d:\adt-bundle-windows-x86\apache-ant-1.9.3\binADDED-> Added: ANT_ROOT = d:\adt-bundle-windows-x86\apache-ant-1.9.3\binSet up successfull:COCOS_CONSOLE_ROOT was added into registryNDK_ROOT was added into registryANDROID_SDK_ROOT was added into registryANT_ROOT was added into registryPlease restart the terminal or restart computer to make added system variables take effect命令最后提示我们重新启动终端或者重新启动系统,以让这些环境变量生效,一般我们关闭cmd和资源浏览器即可了,假设后面遇到环境变量找不到的错误,直接重新启动系统试试吧。要測试环境变量是否生效,又一次打开cmd,输入以下命令查看,正常应该是这样:F:\cocos2dx\cocos2d-x-3.0rc0>set NDK_ROOTNDK_ROOT=d:\adt-bundle-windows-x86\android-ndk-r8eF:\cocos2dx\cocos2d-x-3.0rc0>set ANT_ROOTANT_ROOT=d:\adt-bundle-windows-x86\apache-ant-1.9.3\binF:\cocos2dx\cocos2d-x-3.0rc0>set ANDROID_SDK_ROOTANDROID_SDK_ROOT=D:\adt-bundle-windows-x86\sdkF:\cocos2dx\cocos2d-x-3.0rc0>set COCOS_CONSOLE_ROOTCOCOS_CONSOLE_ROOT=F:\cocos2dx\cocos2d-x-3.0rc0\tools/cocos2d-console/bin
新建和构建project
1. 新建project
我们要用tools\cocos2d-console这个工具来新建project,这个工具提供了以下几个功能:我们如今仅仅用到new,让我们看看new提供了哪些參数,打到cmd,输入:
- new 创建一个新的project
- compile 编译当前project,生成二进制文件,个人认为写为build更贴切一些。
- deploy 公布程序到一个平台
- run 编译和公布,和执行程序
cocos new --help得到以下帮助:usage: cocos new [-h] [-p PACKAGE_NAME] -l {cpp,lua,js} [-d DIRECTORY][-t TEMPLATE_NAME] [--no-native][PROJECT_NAME]创建一个新project必要參数:PROJECT_NAME project名可选參数:-h, --help 显示帮助信息-p PACKAGE_NAME, --package PACKAGE_NAME设置包名,如com.colin.mbgame-l {cpp,lua,js}, --language {cpp,lua,js}使用的主要语言,能够是:[cpp | lua | js]-d DIRECTORY, --directory DIRECTORYproject所在的文件夹-t TEMPLATE_NAME, --template TEMPLATE_NAME要创建的project模板名lua/js project參数:--no-native No native support.
如今我们在cmd中输入:
F:\cocos2dx>cocos new mygame1 -p com.colin.mbgame -l cpp -d f:\cocos2dx\mbgame得到以下输出:F:\cocos2dx>python F:\cocos2dx\cocos2d-x-3.0rc0\tools\cocos2d-console\bin\/cocos .pynew mygame1 -p com.colin.mbgame -l cpp -d f:\cocos2dx\mbgameRuning command: new> Copy template into f:\cocos2dx\mbgame\mygame1> Copying cocos2d-x files...> Rename project name from 'HelloCpp' to 'mygame1'> Replace the project name from 'HelloCpp' to 'mygame1'> Replace the project package name from 'org.cocos2dx.hellocpp' to 'com.colin.mbgame'
这表明我们已经成功创建一个project,到 f:\cocos2dx\mbgame\看看,project文件夹结构例如以下:--<mygame1>--<Classes>--<cocos2d>--<proj.android>--<proj.ios_mac>--<proj.linux>--<proj.win32>--<Resources>--.cocos-project.json--CMakeLists.txt能够看到各种平台下的project都创建出来了,同一时候它把cocos2d整个框架都拷贝过来了,这样的好坏就见仁见智了,
2. 构建Androidproject
同一时候是用到 cocos2d-console,这里要用的是compile这个命令,在cmd输入以下查看帮助:f:\cocos2dx\mbgame\mygame1> cocos compile --helpusage: cocos compile [-h] [-s SRC_DIR] [-q] [-p PLATFORM] [-m MODE] [-j JOBS][--ap ANDROID_PLATFORM] [--source-map]把当前project编译为二进制可选參数:-h, --help 显示帮助信息-s SRC_DIR, --src SRC_DIRproject根文件夹,比方上面应该是f:\cocos2dx\mbgame\mygame1假设不设,就为当前文件夹(cmd定位到的那个文件夹)-q, --quiet less output-p PLATFORM, --platform PLATFORM选择一个平台 android|ios|mac|web|win32|linux-m MODE, --mode MODE 编译模式 debug|release, 默觉得debug.-j JOBS, --jobs JOBS 半行编译,假设你有4核,能够设为4。Android Options:--ap ANDROID_PLATFORM指定SDK版本号?没试过,不敢枉下定论,保留英文:parameter for android-update.Without the parameter,thescript just build dynamic library for project. Validandroid-platform are:[10|11|12|13|14|15|16|17|18|19]Web Options:--source-map Enable source-map
如今我们在cmd输入:
F:\cocos2dx\mbgame\mygame1>cocos compile -p android -j 4意思就是说我们要编译当前文件夹下的Androidproject,同一时候能够有4个编译任务,所以我的4核机器就满负的跑了,如无意外,应该能够看到编译開始了,最后假设看到以下这几句,说明编译成功:
BUILD SUCCESSFUL Total time: 7 seconds Move apk to F:\cocos2dx\mbgame\mygame1\bin\debug\android build succeeded.
我们到 f:\cocos2dx\mbgame\mygame1\proj.android\bin\,能够看到 mygame1-debug.apk,说明构建完毕。
我把它安装到手机上试跑,发现好像启动速度是快了非常多,不知是不是心理作用。
在Eclipse下执行程序
还记得我们下的adt里面有eclipse吗,如今我们就来把project导入到eclipse跑跑看
- 到d:\adt-bundle-windows-x86\eclipse打到eclipse.exe
第一次会提示设置工作区,你能够设置工作区放在哪里,我这里为了演示就默认了。
- 接下来我们要看看SDK和NDK的路径是否正确:
- 选择Windwos/Preferences菜单项,打开选项对话框。
- 选择Android结点,看看SDK Location是否正确,我这里为F:\software\adt-bundle-windows-x86-20131030\sdk,说明是正确的,假设没有值,就手动把SDK的根文件夹设进去。
- 接着选择Android/NDK结点,在NDK Location输入d:\adt-bundle-windows-x86\android-ndk-r8e
- 接下来我们来导入project,选择file/import,打开导入对话框:
- 选择Android/Existing Android Code Into Workspace,然后Next。
- 第一步要先把libcocos2dx导进来:
- 在Root Directory输入F:\cocos2dx\mbgame\mygame1\cocos2d\cocos\2d\platform\android\java
- 此时列出libcocos2dxproject,点击finish把project导进来。
- 第二步导入我们的project:
- 在Root Directory输入F:\cocos2dx\mbgame\mygame1\proj.android。
- 此时会列出mygame1project,点击finish把project导进来。
- 最后连接手机,选择执行或调试就能够跑程序了。
- 在导入project到Eclipse时遇到几个坑,在这里记下来,免得后面的人继续踩这些坑:
- 没有导libcocos2dx,仅仅导mygame1时不会有编译错误,但跑起来后会ClassNotFound异常,说找不到org/cocos2dx/lib/Cocos2dxHelper类,这个问题搞了我好久,后来在论坛看到贴子才明确,希望兴许官方有具体的文档。
- 由于adt仅仅包括了android4.4(api-19)的版本号,所以默认使用的是这个版本号,我自己拷了几个更低的版本号,然后把Build target设为android2.3(api-9),此时执行程序会提示以下错误:
Unable to execute dex: java.nio.BufferOverflowException后来在网上查了一下,发现是 Android SDK Build tools的BUG,把它升级到 19.0.3后就好了:打开SDK Manager,找到19.0.3的Android SDK Build Tools,安装之。