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

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

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.   创建工程

2.x

cocos2d-x\tools\project-creator目录下，命令行执行python create_project.py –project ABC –package com.xyz.abc –language cpp创建工程

创建好的工程目录在cocos2d-x\projects，不能复制到其他路径，否则会有工程依赖问题。

3.0

cmd命令行进入自己选择的工程路径，执行cocos new MyGame -p com.your_company.mygame -l cpp

等待工程创建完毕。

3.0版本会把依赖的cocos2dx源文件复制到自己创建的工程目录，在cocos2d文件夹下。所以不存在拷贝工程引起的依赖问题。

3.   编译工程

创建完成后，cd进入工程目录，执行cocos compile –p android –j 4编译工程，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.   清理工程

官方文档的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可用，原因不明，那就不用命令清理工程了，改用手动清理吧，很简单，需要清理时把porj.android目录bin, obj, libs, assets, gen目录都删除就好了。可以写个脚本完成。

6.   开发环境

cocos2d-x2.x版本创建的工程可以直接使用vs2010编译。在windows上开发调试好后移植到android平台就可以了。升级到3.0版本后，由于使用了c++11，最低支持版本为vs2012。vs2012要求win7以上os，没法在xp系统上调试程序了。

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

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

1)      在游戏工程根目录创建一个codeblocks空工程。

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应该就可以过滤掉其他信息了，但执行后发现什么信息都没有了，这是为什么？

另外创建了个android工程，调试后发现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。

重新编译工程，命令行执行adblogcat cocos2d-x_debug_info:D *:S，可以正常过滤了，只显示cocos2dx的log输出。

注意，如果修改的是工程路径下的cocos2d\cocos\base\CCConsole.cpp文件，下次创建新工程，log函数的tag还是cocos2d-x debuginfo，想一劳永逸的话，可以修改cocos2d-x-3.0\cocos\base\CCConsole.cpp。这样创建新工程就会把这个文件拷贝到新工程下，就不用每次都修改了。

Windows平台cocos2d-x 3.0 android开发环境,,5-wow.com