1. 配置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_21
CLASSPATH=.;%JAVA_HOME%\lib;
Path增加%JAVA_HOME%\bin;
本文假设你知道怎么设置环境变量,如果不知道,请使用搜索引擎查找相关资料,设置完后打开cmd,输入java -version
如果出现下面提示,表明环境变量设置成功:
C:\Users\arlin>java -version
java 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。
3. 下载Android NDK下载地址是:http://developer.android.com/sdk/index.html
可以选择32位或64位版本,我选择的是32位版的,把它解压到一个目录,我这里是:d:\adt-bundle-windows-x86\,目录结构如下:
--<adt-bundle-windows-x86>
--<eclipse>
--<sdk>
--SDK Manager.exe
4. 下载ANT下载地址是:http://developer.android.com/tools/sdk/ndk/index.html
同样有32位和64位版可选,我选择的是32位版的,把它解压到adt同目录下,现在adt的目录结构如下:
--<android-ndk-r8e>
--SDK Manager.exe
5. 下载PythonANT是为了自动构建Android程序用。
下载地址是:http://ant.apache.org/bindownload.cgi
我选择的是: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
-
原来cocos2dx在不同平台下必须用不同的脚本来创建和构建工程,3.0以后都统一用python了,所以Windows下需要安装python环境:
下载地址:https://www.python.org/ftp/python/2.7.3/python-2.7.3.msi
原来下载了最新的版本,使用setup.py的时候发现有语法错误,所以最好使用2.7.3版本,亲测过没有问题
-
配置环境变量:最新版本可以自动加进path环境变量,但2.7.3不行,所以我们只能自己设置一下,假设我的Python安装在:d:\Python27\
把这个路径加到path环境变量中,当我们在cmd下输入python,出现下面字样,就说明环境变量设置正确了:
C:\Users\arlin>python
Python 2.7.3 (default,Apr 10 2012,23:31:26) [MSC v.1500 32 bit (Intel)] on win32
Type "help","copyright","credits" or "license" for more information.
>>>
cocos2d-x下载与配置
1. 下载cocos2d-x
2. 设置环境变量目前最新版本是3.0RC,下载地址是:http://cocostudio.download.appget.cn/Cocos2D-X/3.0RC0/cocos2d-x-3.0rc0.zip
下载完解压到一个地方,我这里:f:\cocos2dx\cocos2d-x-3.0rc0\
cc需要下面几个环境变量,用于后面的新建工程,构建工程等:
-
COCOS_CONSOLE_ROOT: cocos控制台路径,控制台用于新建,构建,发行工程。
-
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-cons
ole/bin
-> Looking for NDK_ROOT envrironment variable... NOT FOUND
Please enter its path (or press Enter to skip):d:\adt-bundle-windows-x8
6\android-ndk-r8e
ADDED
-- Added: NDK_ROOT = d:\adt-bundle-windows-x86\android-ndk-r8e
-> Looking for ANDROID_SDK_ROOT envrironment variable... NOT FOUND
D:\adt-bundle-windows-x8
6\sdk
-> Added: ANDROID_SDK_ROOT = D:\adt-bundle-windows-x86\sdk
-> Looking for ANT_ROOT envrironment variable... NOT FOUND
Please enter its path (or press Enter to skip): d:\adt-bundle-windows-x8
6\apache-ant-1.9.3\bin
-> Added: ANT_ROOT =d:\adt-bundle-windows-x86\apache-ant-1.9.3\bin
Set up successfull:
COCOS_CONSOLE_ROOT was added into registry
NDK_ROOT was added into registry
ANDROID_SDK_ROOT was added into registry
ANT_ROOT was added into registry
Please restart the terminal or restart computer to make added system variables t
ake effect
命令最后提示我们重启终端或者重启系统,以让这些环境变量生效,一般我们关闭cmd和资源浏览器就行了,如果后面遇到环境变量找不到的错误,直接重启系统试试吧。
要测试环境变量是否生效,重新打开cmd,输入下面命令查看,正常应该是这样:
F:\cocos2dx\cocos2d-x-3.0rc0>set NDK_ROOT
NDK_ROOT=d:\adt-bundle-windows-x86\android-ndk-r8e
F:\cocos2dx\cocos2d-x-3.0rc0>set ANT_ROOT
ANT_ROOT=d:\adt-bundle-windows-x86\apache-ant-1.9.3\bin
F:\cocos2dx\cocos2d-x-3.0rc0>set ANDROID_SDK_ROOT
ANDROID_SDK_ROOT=D:\adt-bundle-windows-x86\sdk
F:\cocos2dx\cocos2d-x-3.0rc0>set COCOS_CONSOLE_ROOT
COCOS_CONSOLE_ROOT=F:\cocos2dx\cocos2d-x-3.0rc0\tools/cocos2d-console/bin
我们要用tools\cocos2d-console这个工具来新建工程,这个工具提供了下面几个功能:
我们现在只用到new,让我们看看new提供了哪些参数,打到cmd,输入:
cocos new --help
得到下面帮助:
usage: cocos new [-h] [-p PACKAGE_NAME] -l {cpp,lua,js} [-d DIRECTORY]
[-t TEMPLATE_NAME] [--no-native]
[PROJECT_NAME]
创建一个新工程
必要参数:
PROJECT_NAME 工程名
可选参数:
-h,--help 显示帮助信息
-p PACKAGE_NAME,--package PACKAGE_NAME
设置包名,如com.colin.mbgame
-l {cpp,js},--language {cpp,js}
使用的主要语言,可以是:[cpp | lua | js]
-d DIRECTORY,--directory DIRECTORY
工程所在的目录
-t TEMPLATE_NAME,--template TEMPLATE_NAME
要创建的工程模板名
lua/js 工程参数:
--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.py
new mygame1 -p com.colin.mbgame -l cpp -d f:\cocos2dx\mbgame
Runing 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'
这表明我们已经成功创建一个工程,到f:\cocos2dx\mbgame\看看,工程目录结构如下:
--<mygame1>
--<Classes>
--<cocos2d>
--<proj.android>
--<proj.ios_mac>
--<proj.linux>
--<proj.win32>
--<Resources>
--.cocos-project.json
--CMakeLists.txt
可以看到各种平台下的工程都创建出来了,同时它把cocos2d整个框架都拷贝过来了,这种好坏就见仁见智了,
同时是用到cocos2d-console,这里要用的是compile这个命令,在cmd输入下面查看帮助:
f:\cocos2dx\mbgame\mygame1>cocos compile --help
usage: cocos compile [-h] [-s SRC_DIR] [-q] [-p PLATFORM] [-m MODE] [-j JOBS]
[--ap ANDROID_PLATFORM] [--source-map]
把当前工程编译为二进制
可选参数:
显示帮助信息
-s SRC_DIR,--src SRC_DIR
工程根目录,比如上面应该是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,the
script just build dynamic library for project. Valid
android-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
意思就是说我们要编译当前目录下的Android工程,同时可以有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吗,现在我们就来把工程导入到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
接下来我们来导入工程,选择file/import,打开导入对话框:
在Root Directory输入F:\cocos2dx\mbgame\mygame1\proj.android。
此时会列出mygame1工程,点击finish把工程导进来。
在Root Directory输入F:\cocos2dx\mbgame\mygame1\cocos2d\cocos\2d\platform\android\java
此时列出libcocos2dx工程,点击finish把工程导进来。
选择Android/Existing Android Code Into Workspace,然后Next。
第一步要先把libcocos2dx导进来:
第二步导入我们的工程:
最后连接手机,选择运行或调试就可以跑程序了。
在导入工程到Eclipse时遇到几个坑,在这里记下来,免得后面的人继续踩这些坑:
原文链接:https://www.f2er.com/cocos2dx/343363.htmlUnable to execute dex: java.nio.BufferOverflowException
后来在网上查了一下,发现是Android SDK Build tools的BUG,把它升级到19.0.3后就好了:打开SDK Manager,找到19.0.3的Android SDK Build Tools,安装之。