Windows平台cocos2d-x 3.0 android开发环境

cocos2d-x升级到3.0后变化不小，除了API的变化（主要是函数和类名称变化，以及使用了C++11的很多特性。function/bind, lamda, std::thread…），建立和编译project也作了一些简化调整。本文主要讨论一下cocos2d-x3.0 在android平台开发的环境设置及project建立编译流程。

1.   初始设置

除了2.x所需要的python,jdk, android sdk和ndk以外，还需要部署apache-ant。

1)      在path中设置好java环境变量：

JAVA_HOME=C:\jdk_xx.xx.xx

path加上%JAVA_HOME%\bin;

CLASSPATH=.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar

2)      安装python 2.x版本号。

3)      部署好android sdk, ndk, ant以后，运行...\cocos2d-x-3.0\ setup.py。

提示输入ndk。sdk和ant文件夹。这里要注意，androidsdk设置为 …\adt-bundle-windows-x86\sdk，ndk文件夹设置为…\android-ndk，而ant文件夹要设置为…\apache-ant\bin，和前二者设置为根文件夹不一样，要设置到bin文件夹。不然不生效。部署apk的时候会提示找不到ant。

4)      三个文件夹设置完毕后本身主动关闭setup.py脚本。开发环境设置完毕。

2.   建立project

2.x

cocos2d-x\tools\project-creator文件夹下，命令行运行python create_project.py –project ABC –package com.xyz.abc –language cpp建立project

建立好的project文件夹在cocos2d-x\projects，不能拷贝到其它路径，不然会有project依赖问题。

 

3.0

cmd命令行进入本身选择的project路径，运行cocos new MyGame -p com.your_company.mygame -l cpp

等待project建立完毕。

3.0版本号会把依赖的cocos2dx源文件拷贝到本身建立的project文件夹，在cocos2d文件夹下。因此不存在拷贝project引发的依赖问题。

3.   编译project

建立完毕后，cd进入project文件夹。运行cocos compile –p android –j 4编译project，cocos run –p android –j 4编译+部署apk+运行。

-p參数指定平台

-j參数指定使用多少个线程运行编译，官方的说法是可以加快编译速度。（可选项）

默认是debug编译，-m release可以指定编译为公布版。注意。release必须小写。写成Release无效。

不少其它參数參见官方文档：

https://github.com/cocos2d/cocos2d-console/issues/27

4.   部署apk

cocos deploy –p android部署编译好的apk。cocos run –p android可以编译好直接部署。

5.   清理project

官方文档的cocos clean命令运行后提示Error:argument 'clean' not found。

看一下cocos2dx的命令脚本，文件夹在cocos2d-x-3.0\tools\cocos2d-console。

查看bin文件夹下的cocos2d.ini：

#

#cocos2d command line tool configuration file

#

[plugins]

project_new.CCPluginNew

project_compile.CCPluginCompile

project_run.CCPluginRun

project_deploy.CCPluginDeploy

plugin_jscompile.CCPluginJSCompile

#plugin_version.CCPluginVersion

#plugin_install.CCPluginInstall

#plugin_update.CCPluginUpdate

#plugin_clean.CCPluginClean

#plugin_dist.CCPluginDist

# To adda new plugin add it's classname here

可以看到clean命令被凝视掉了，仅仅有new,compile, run, deploy可用，缘由不明，那就不用命令清理project了，改用手动清理吧。很是easy，需要清理时把porj.android文件夹bin, obj, libs, assets, gen文件夹都删除就行了。可以写个脚本完毕。

6.   开发环境

cocos2d-x2.x版本号建立的project可以直接使用vs2010编译。

在windows上开发调试好后移植到android平台就可以了。升级到3.0版本号后，由于使用了c++11，最低支持版本号为vs2012。

vs2012要求win7以上os，无法在xp系统上调试程序了。

既然如此，就不win32project进行开发了，直接编译android平台。也省去了移植这一过程。

命令行编译部署androidproject前面都介绍过了，如下需要的就是选择一个IDE方便开发。这里推荐codeblocks。建立project过程例如如下：

1)      在游戏project根文件夹建立一个codeblocks空project。

2)      加入Classes和cocos2d文件夹所有文件。

3)      预编译宏定义加入ANDROID 指定平台。

设置完毕。就可以进行开发了。需要编译时命令行运行cocos compile –p android –j 4就可以了。

依据命令行提示的错误代码行在codeblockside中查找相应源文件的相应行来定位bug。

加入新文件时可不要仅仅在codeblocks里加入。还要在proj.android/jni/Android.mk中加入LOCAL_SRC_FILES。

另外，假设需要使用cocos2dx的extensions模块，也需要改动Android.mk文件。

改动例如如下：

LOCAL_C_INCLUDES:= $(LOCAL_PATH)/../../Classes \

                                               $(LOCAL_PATH)/../../cocos2d\extensions

LOCAL_WHOLE_STATIC_LIBRARIES+= cocos_extension_static

$(call import-module,extensions)

加入其它模块与之类似。

7.   Log输出

cocos2d-x3.0使用新的打印函数log（2.x版本号是CCLog），咱们需要使用adb和logcat工具查看log输出(要在命令行里使用adb，记得配置adt-bundle-windows-x86\sdk\platform-tools到path)。

命令行运行adb logcat。假设android设备链接USB或者开着模拟器。就可以看到输出的log信息了，但信息太多。程序里打印的重要信息很是快会被淹没。必须设置过滤条件。

可以看到cocos2d-x的log信息格式为 D/cocos2d-xdebug info(12358): xxxx。

D表示debug。表示打印优先级。优先级是如下的字符，顺序是从低到高：

V — 明细 (最低优先级)

D — 调试

I — 信息

W — 警告

E — 错误

F — 严重错误

S — 无记载 (最高优先级，没有什么会被记载)

logcat的使用详见http://blog.csdn.net/xyz_lmn/article/details/7004710

运行adb logcat cocos2d-xdebug info:D *:S应该就可以过滤掉其它信息了，但运行后发现什么信息都没有了，这是为何？

另外建立了个androidproject。调试后发现tag里有空格adb就没法正确过滤，问题清楚了。如下需要改动一下cocos2dx的log函数。

打开cocos2d\cocos\base\CCConsole.cpp，找到_log函数（log和CCLog都调用这个），里面

#ifCC_TARGET_PLATFORM == CC_PLATFORM_ANDROID

__android_log_print(ANDROID_LOG_DEBUG, "cocos2d-x debug info",  "%s", buf);

改动cocos2d-x debug info为cocos2d-x_debug_info。

又一次编译project，命令行运行adblogcat cocos2d-x_debug_info:D *:S，可以正常过滤了，仅仅显示cocos2dx的log输出。

注意，假设改动的是project路径下的cocos2d\cocos\base\CCConsole.cpp文件。下次建立新project。log函数的tag仍是cocos2d-x debuginfo，想一劳永逸的话，可以改动cocos2d-x-3.0\cocos\base\CCConsole.cpp。

这样建立新project就会把这个文件拷贝到新project下，就不用每次都改动了。