今天我们要说的是Cocos2d-x 3.0正式版及android环境搭建详细教程,3.0正式版的环境搭建和之前的RC版其实是一样的,太多的教程也写了如何搭建,今天来写写我自己是如何来搭建的。

我的开发环境是:mac + xcode + eclipse ,其实现在win下面的环境和这个都是一样的,唯一不一样的就是环境变量的配置。

下面主要介绍cocos2d-x环境的设置以及android的环境搭建
1、下载cocos2d-x 3.0正式版
 http://www.cocos2d-x.org/download
2、下载android的sdk以及ndk
 http://developer.android.com/sdk/index.html
3、下载ant
 http://ant.apache.org
(注:cocos2d-x的环境变量配置需要用到ant,主要是android需要使用到它)
4、下载python 2.7.6(不要下载python3.0以上的版本,正常mac上都有自带,也无需下载)
 https://www.python.org/download/releases/2.7.6/

必备工具都下载好了,现在开始搭建环境了。

5、配置.bash_profile(该文件在/Users/xuzhiwei/.bash_profile下,没有可以自行创建)
复制代码
  1. export NDK_ROOT=/Users/xuzhiwei/Develop/program/android/android-ndk-r9d
  2. export ANDROID_SDK_ROOT=/Users/xuzhiwei/Develop/program/android/adt-bundle-mac-x86_64/sdk
  3. export ANT_ROOT=/Users/xuzhiwei/Develop/program/apache-ant-1.9.3
  4. export PATH=$ANT_ROOT/bin:$PATH

以上配置了android sdk、ndk还有ant的环境变量,这样就好了

6、现在开始配置3.0的环境变量,这个方便了很多
只需要运行3.0的目录下setup.py就好了
  1. 复制代码
  2. python setup.py

如图:


根据提示执行
  1. 复制代码
  2. source /Users/xuzhiwei/.bash_profile

命令刷新一下配置文件就可以了。这样的环境搭建就完成了。

7、创建项目,相信使用过3.0的大侠们都知道有个cocos的命令。

这里执行下   cocos -h 看下帮助


这个其他教程也说了很多遍了,我就不多说了。直接创建项目.



8、找到创建的目录


使用xcode打开项目,然后运行编译即可


整个环境就这样搭建完成了。


9、接下来要说的还是android的相关部分了。

首先,进入到proj.android下通过命令执行
  1. 复制代码
  2. python build_native.py

然后他就开始进行编译了。


编译完成后打开,使用eclipse打开,并导入可以看到有红色的“*”.


这里是因为少了包,右击属性可以看到


到test3.0/cocos2d/cocos/2d/platform/android/java/src下把类包拷到当前项目的src下即可,或者通过类库项目的方式进行引用。


这样就没有问题。
不过问题来了,每次这么创建都要去copy实在是太麻烦了。
接下来修改一下模板中的build_native.py文件,以后就让命令来帮我们一起将类包考进去。


10、修改模板类中的build_native.py

你可以在“cocos2d-x-3.0/templates/cpp-template-default/proj.android”下找到build_native.py进行修改。


贴下代码吧,以上中文就是我修改的地方,下面只贴关键部分代码,大家自行copy
  1. 复制代码
  2. def copy_resources(app_android_root):
  3. # remove app_android_root/assets if it exists
  4. assets_dir = os.path.join(app_android_root, "assets")
  5. if os.path.isdir(assets_dir):
  6. shutil.rmtree(assets_dir)
  7. # copy resources
  8. os.mkdir(assets_dir)
  9. resources_dir = os.path.join(app_android_root, "../Resources")
  10. if os.path.isdir(resources_dir):
  11. copy_files(resources_dir, assets_dir)
  12. #--------copy cocos_lib_path start------------
  13. def copy_src_files(src, dst):
  14. for item in os.listdir(src):
  15. path = os.path.join(src, item)
  16. if not item.startswith('.') and os.path.isfile(path):
  17. shutil.copy(path, dst)
  18. if os.path.isdir(path):
  19. new_dst = os.path.join(dst, item)
  20. if not os.path.exists(new_dst):
  21. os.mkdir(new_dst)
  22. copy_src_files(path, new_dst)
  23. def copy_src(app_android_root,cocos_root):
  24. android_src_dir = os.path.join(app_android_root,"src")
  25. cocos_src_path = os.path.join(cocos_root, "cocos/2d/platform/android/java/src")
  26. if not os.path.exists(android_src_dir) :
  27. os.mkdir(android_src_dir)
  28. if os.path.isdir(cocos_src_path):
  29. copy_src_files(cocos_src_path,android_src_dir)
  30. #--------copy cocos_lib_path end------------
  31. def build(ndk_build_param,android_platform,build_mode):
  32. ndk_root = check_environment_variables()
  33. sdk_root = None
  34. select_toolchain_version()
  35. current_dir = os.path.dirname(os.path.realpath(__file__))
  36. cocos_root = os.path.join(current_dir, "../cocos2d")
  37. app_android_root = current_dir
  38. copy_resources(app_android_root)
  39. #-----------------add copy src ------------
  40. copy_src(app_android_root,cocos_root)
  41. if android_platform is not None:
  42. sdk_root = check_environment_variables_sdk()
  43. if android_platform.isdigit():
  44. android_platform = 'android-'+android_platform
  45. else:
  46. print 'please use vaild android platform'
  47. exit(1)
  48. if build_mode is None:
  49. build_mode = 'debug'
  50. elif build_mode != 'release':
  51. build_mode = 'debug'
  52. do_build(cocos_root, ndk_root, app_android_root,ndk_build_param,sdk_root,android_platform,build_mode)

好了,修改模板的好处就是一次修改,多次使用哈。

下面你可以在创建一个项目,然后执行   python build_native.py  看看是不是把类包一起打包进项目了哈。

以上就是整个的环境搭建过程,看起来有点儿多,不过最好还有一个东西也是要放到模板下的。

那就是为了方便以后copy 创建的cpp文件到android.mk下,往模板的proj.android下的JNI下添加list.sh文件。

下载包: list.sh.zip 

使用方法很简单:
  1. 复制代码
  2. ./list.sh ../../Classes
这样就可以列出Classes下的cpp了,这样就可以直接copy到android.mk目录下了。