一年多的时间里,接触到了cocos2d js比较多的东西,也一直没有整理出来,现在抽时间整理出来。网上资料相对来说也不是很多,可以方便后面查阅。
cocos2d js介绍
上面的图表示了cocos2d js游戏的一个架构组成,首先它是一个跨平台的游戏引擎,包含了cocos2d js Api和一些和底层交互的JSB,后续我们也主要围绕着这两个模块一起来了解,从而实现可快速开发一个cocos js game。详细的介绍可参考官网介绍:
http://www.cocos.com/docs/js/
话不多说,下面主要介绍一下环境搭建和其中可能遇到的坑。
第一步 准备工作
(1)下载cocos2d js引擎包:http://cocos2d-x.org/filedown/cocos2d-x-3.17.zip
下载完成之后,可打开README.md文件,可以看到构建要求如下:
Build Requirements
------------------
* Mac OS X 10.7+, Xcode 8+
* or Ubuntu 14.04+, CMake 3.1+
* or Windows 7+, VS 2015
* Python 2.7.5+(NOT Python 3)
* NDK r16+ is required to build Android games
* Android Studio 3.0.0+ to build Android games(tested with 3.0.0)
* JRE or JDK 1.6+ is required for web publishing
Runtime Requirements
--------------------
* iOS 8.0+ for iPhone / iPad games
* Android 3.0.0+ for Android
* OS X v10.9+ for Mac games
* Windows 7+ for Win games
* Modern browsers and IE 9+ for web games
Running Tests
--------------------
因为我是Mac,所以直接从Mac环境介绍了,其中需要注意到的是NDK版本要是r16+,如果你也是Mac环境,python也不用再去装了,环境自带的是有的,可使用python查看下版本,在要求版本之上即可。
Last login: Tue Aug 14 20:17:21 on console
192:~ luomingjun$ python
Python 2.7.10 (default, Oct 6 2017, 22:29:07)
[GCC 4.2.1 Compatible Apple LLVM 9.0.0 (clang-900.0.31)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>
(2)下载Android adt ndk ant jdk
adt: http://www.androiddevtools.cn/#
ndk:https://developer.android.google.cn/ndk/downloads/
ant: https://ant.apache.org/bindownload.cgi
jdk: http://www.androiddevtools.cn/#
ndk安装:
ndk有的是安装文件,有的是直接目录文件,配置很简单,直接在.bash_profile中增加配置即可,注意在配置完之后source ~/.bash_profile下,遍可立即生效:
测试命令:ndk-build 出来东西即可
ant 安装
和ndk安装差不多,但需要制定到bin/目录
测试命令:ant -version
jdk安装
测试:javac
第二步 cocos 命令创建项目
如果第一步完成了,接下来我们便可以创建一个cocos2d js的一个项目啦
Last login: Wed Aug 15 00:32:20 on ttys001
192:~ luomingjun$ cd /Users/luomingjun/Documents/tools/cocosjs/cocos2d-x-3.17
192:cocos2d-x-3.17 luomingjun$ ./setup.py
Setting up cocos2d-x...
->Check environment variable COCOS_CONSOLE_ROOT
->Search for environment variable COCOS_CONSOLE_ROOT...
->COCOS_CONSOLE_ROOT is found : /Users/luomingjun/Documents/tools/cocosjs/cocos2d-x-3.17/tools/cocos2d-console/bin
->Check environment variable COCOS_X_ROOT
->Search for environment variable COCOS_X_ROOT...
->COCOS_X_ROOT is found : /Users/luomingjun/Documents/tools/cocosjs
->Check environment variable COCOS_TEMPLATES_ROOT
->Search for environment variable COCOS_TEMPLATES_ROOT...
->COCOS_TEMPLATES_ROOT is found : /Users/luomingjun/Documents/tools/cocosjs/cocos2d-x-3.17/templates
->Configuration for Android platform only, you can also skip and manually edit "/Users/luomingjun/.bash_profile"
->Check environment variable NDK_ROOT
->Search for environment variable NDK_ROOT...
->NDK_ROOT is found : /Users/luomingjun/Documents/tools/cocosjs/android-ndk-r16b
->Check environment variable ANDROID_SDK_ROOT
->Search for environment variable ANDROID_SDK_ROOT...
->ANDROID_SDK_ROOT is found : /Users/luomingjun/Library/Android/sdk
->Check environment variable ANT_ROOT
->Search for environment variable ANT_ROOT...
->ANT_ROOT is found : /Users/luomingjun/Documents/tools/cocosjs/apache-ant-1.10.5
Please execute command: "source /Users/luomingjun/.bash_profile" to make added system variables take effect
192:cocos2d-x-3.17 luomingjun$
1.先切换到下载在引擎库根目录下,然后执行 ./setup.py ,第一步所有都成功情况下,这里的环境路径都是可以找到的,接下来我们创建我们的项目
创建一个cocos2d-x JSB和cocos2d-html5工程
cocos new projectName -l js
创建一个项目名为projectName的工程,创建目录为当前命令所执行的目录,一般需要先切换到对应目录之后,再次进行创建项目。
第二步 cocos 命令运行工程
1.切换到项目projectName根目录
cocos run -p web
可以看到一个8080端口的网页打开会出现网页版的Hello World的字样,自此cocos2d-x环境搭建结束。
也还有其他的一些编译或者运行的命令,如下
cocos compile -p ios|android|mac
cocos run -p ios|android|mac
关于其他命令,可自行官网查询。