Win8.1系统Cocos2d-x 3.4环境搭建
Win8上市后,我第一时间将系统进行了升级。在做项目时,遇到了环境搭建的问题,现在把自己的一些经验分享给大家。
第一步:所需资源下载(Windows 64位系统下环境搭建)
以下是搭建环境所需下载的资源:
- Ant:apache-ant-1.9.4-bin.zip
- NDK:android-ndk-r9d-windows-x86_64.zip
- SDK:adt-bundle-windows-x86_64-20130729.zip
- VS2012
- cocos2d-x-3.4.zip
- python_2.7.8_32
- jdk-8-windows-x64.exe
另外,有两个重要的命令:
cocos new -p com.game.simple -l cpp -d e:\ simple:用于创建项目。cocos compile -p android:用于将项目编译成apk文件。
第二步:安装Python
Cocos2d-x的很多工具都需要使用Python,因此我们需要先安装Python环境。需要下载Python 2.X版本,请勿下载3.x版本。
Python安装时使用默认安装方式即可,但安装完毕后需要配置环境变量。具体操作如下:在“我的电脑”上右键,选择“属性”,然后点击“高级系统设置”,在“高级”选项卡中找到“环境变量”,在系统变量中找到“Path”变量,并在其值中增加指向Python的环境变量,格式为 [Python安装路径];。例如,若安装在C盘,环境变量可新增为 C:\Python27;。
配置完毕后,需要注销并重新登录系统,环境变量才会生效。
注意:有时安装Python后,也在“Path”中配置好了,但还是会提示“Python不是内部命令”。如果遇到这种情况,每次在cmd命令框中执行 cocos new 或者 python 等命令时,都要手动执行一下 set PATH=%PATH%;C:\Python27(这里假设Python安装在C盘根目录下,具体路径视安装情况而定),然后才能执行Cocos等命令。步骤如下:
- 运行“cmd”。
- 输入
set PATH=%PATH%;C:\Python27。 - 接下来,在当前的cmd中输入
python,若出现版本信息,则表示安装成功。
第三步:配置Cocos2d-x环境
进入Cocos2d-x文件夹,找到 setup.py 文件并运行,会弹出控制台。由于此时不配置Android环境,只需一直回车即可。这段Python脚本会帮助我们设置Cocos2d-x运行所需的环境变量。设置完成后,同样需要注销并重新登录系统,环境变量才会生效。
配置完成后,打开CMD,运行 Cocos 命令。一是为了检查整个开发环境是否搭建成功,二是可以熟悉下命令行。如果设置没问题,会出现相应界面。在这里可以看到 cocos.py 脚本可以执行4个命令,每个命令的作用都有清晰说明。
第四步:使用 new 命令创建项目
例如,要创建一个名为 simple 的项目,可以使用以下命令:
cocos new -p com.game.simple -l cpp -d e:\simple
运行这条命令后,会在E盘根目录下生成一个名为 simple 的文件夹,里面存放着项目文件。若出现相应信息,则表示项目创建成功。
此时,可以用VS2012打开 proj.win32 中的 sln 项目文件进行编码和调试工作。
如果要运行刚刚由模板生成的项目,需要用到 cocos run 命令,格式为 cocos run -p [平台]。例如,cocos run -p win32 表示在win32平台运行。执行这条命令时需要注意,执行命令的目录必须是游戏项目的根目录,如果不在根目录,需要使用 -s 指定游戏根目录的位置。
在cmd中执行 cocos run -p win32 -s e:\simple,如果编译过程中没有错误,编译完成后会打开 HelloWorld 的DEMO。至此,环境搭建以及调试发布就全部完成了。
第五步:配置Android编译环境
Android的编译环境在3.0RC里有了很大改观,部署和编译方式比之前方便了很多。Android编译环境需要用到Android_SDK、Android_NDK、Ant与JDK。其中,除了JDK需要安装,其它的是绿色版,直接解压即可。
将SDK、NDK和ANT解压缩到同一个文件夹中,并可将sdk的文件夹名修改为 ADT(此步骤可省略),NDK文件夹保持 NDK,ANT文件夹保持 ANT,这样方便以后使用。例如,我将解压后的文件都放在了 e:\Android 文件夹下。
配置JDK环境变量
JDK安装完毕后,需要手动进行环境变量的配置:
- 在系统变量里新建
JAVA_HOME变量,变量值为JDK的安装路径,例如C:\Program Files\Java\jdk1.6.0_14(需根据自己的安装路径填写)。 - 新建
classpath变量,变量值为.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar(注意前面的.不要忘记)。 - 在
path变量(已存在,无需新建)中添加变量值%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin(注意变量值之间用;隔开)。 - 重新注销系统并重新登录后,点击“开始” -> “运行”,输入“javac”,然后按“Enter”键。如果能正常打印用法说明,则表示配置成功。
环境变量解析:
JAVA_HOME:JDK的安装路径。classpath:Java加载类路径,只有类在classpath中,Java命令才能识别。在路径前加.表示当前路径。path:系统在任何路径下都可以识别java和javac命令。
配置ANT环境变量
将 [ANT目录]\bin 文件夹添加到“Path”变量中。
至此,准备工作就完成了。接下来运行 setup.py 关联SDK、NDK和ANT。在运行过程中,需要输入ndk和sdk的路径,其中ndk指向根目录即可,而sdk需要指向 adt 中的 sdk 目录。由 setup.py 添加这两个环境变量后,会要求输入Ant的路径,这里需要指向 ant 中的 bin 文件夹。
此时,基本环境已经搭建完成,记得注销并重新登录系统,使环境变量生效。重新运行 setup.py,确认所有的配置是否正确。如果全部正确,会提示都已找到。
然后,就可以在创建的项目的根目录下使用 cocos compile -p android 方式编译APK文件。
注意:在打包apk之前,需要修改 proj.android/jni 文件夹下的 Android.mk 文件,添加自己新增的CPP文件。
最后,编译好的APK文件位于 [项目文件夹]\bin\debug\android\ 文件夹下。