Cocos2d console使用手册

背景

Cocos2d console是一个可以为Cocos2d-html5和Cocos2d-JSBingding极大简化游戏创建和环境配置过程的工具。

在Cocos2d-JS v3.0 alpha版中，由于重构了大量以前C++风格的API并为Javascript开发者提供了很友好的API设计，JSB的API也如此改造以保证Html5和JSB之间的代码共享，详细信息请参见发布说明。更重要的是，我们将Cocos2d-html5和Cocos2d-JSBinding合并为一个仓库：Cocos2d-JS。所以只要开发者使用JS开发游戏，那么不论游戏会发布到哪个平台，都可以使用Cocos2d-JS来进行开发。

终端脚本工具

Cocos2d-JS提供了一个终端工具来简化html5和JSB游戏的创建和开发。开发者可以使用它来创建新项目，编译并发布游戏到android，iOS，Mac OS，iOS或者Web平台。并且它非常简单易用，下面将会展示它的安装与使用。

安装

首先，你需要安装这个工具，当开发者将Cocos2d-JS仓库下载下来以后，会在根目录下发现setup.py安装文件。打开终端并进入Cocos2d-JS文件夹，然后运行./setup.py。在安装过程中，你可能需要提供你的NDK，Android SDK和ANT目录。请注意，这个工具是使用python来开发的，你将需要首先安装python 2.7.5或2.7.6，但是setup.py并不支持python3。

一些有用的链接和安装指引:

• Python 2.7.6
• Android SDK
• NDK

• Ant binary release

  • 下载Ant。
  • 将Ant解压到你指定的文件夹。
  • 设置JAVA_HOME环境变量到你的Java路径，ANT_HOME到刚刚解压的文件夹，再将${ANT_HOME}/bin (Unix)或%ANT_HOME%/bin (Windows)加入到PATH中。

  // Example: 在命令行中运行或添加到.bash_profile(Mac)
  export ANT_ROOT=/usr/local/ant/bin
  export JAVA_HOME=/usr/local/jdk1.7.0_51
  

Usage

成功安装以后，开发者就可以开始在终端中使用cocos命令。

创建一个新项目

• 创建一个同时包含Cocos2d-x JSB和Cocos2d-html5的项目:

  cocos new projectName -l js
  

• 创建一个仅支持Cocos2d-html5的项目:

  cocos new projectName -l js --no-native
  

• 创建项目到指定目录:

  cocos new projectName -l js -d ./Projects
  

运行项目

• 使用浏览器运行web版项目:

  cd directory/to/project
  cocos run -p web
  

• 编译并将项目运行在Cocos2d-JSB上:

  cd directory/to/project
  cocos compile -p ios|mac|android|web
  cocos run -p ios|mac|android
  

• 选项

  -p platform : The platform can be ios|mac|android|web.
  -s source   : Your project directory, if not specified the current directory will be used.
  -q          : Quiet mode, remove log messages.
  -m mode     : Mode debug or release, debug is default
  --source-map: General source-map file. (Web platform only)
  

帮助命令

如果你对使用有任何疑问，可以在命令后使用-h来获取对应命令的帮助。下面是所有的命令：

• 创建：new
• 编译：compile
• 运行：run