cocos2d js基础框架搭建及介绍

一年多的时间里，接触到了cocos2d js比较多的东西，也一直没有整理出来，现在抽时间整理出来。网上资料相对来说也不是很多，可以方便后面查阅。

cocos2d js介绍

2018.png

上面的图表示了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
关于其他命令，可自行官网查询。