cocos 命令

Cocos2d-x 带有一个命令行工具:cocos 这是一个跨平台的工具,你可以用它创建项目、运行项目、发布项目。

命令行工具适用于所有 Cocos2d-x 支持的平台,包括:iOS、Android、Mac、Linux、Windows、Web。不用 IDE,只用命令行,你就能完成所有的工作!

本文选自cocos2dx官方文档,只做记录!

项目创建

使用 cocos new 命令创建新项目,命令格式如下:

cocos new <game name> -p <package identifier> -l <language> -d <location>

示例:

cocos new MyGame -p com.MyCompany.MyGame -l cpp -d ~/MyCompany

cocos new MyGame -p com.MyCompany.MyGame -l lua -d ~/MyCompany

cocos new MyGame -p com.MyCompany.MyGame -l js -d ~/MyCompany

使用命令 cocos new –help 可以查看到更多关于项目创建的帮助信息。

项目编译

我们都知道,程序从源码到二进制程序,有一个编译环节。我们来看下 Cocos2d-x 是如何编译项目的,命令格式如下:

cocos compile -s <path to your project> -p <platform> -m <mode> -o <output directory>

示例:

cocos compile -s ~/MyCompany/MyGame -p ios -m release -o ~/MyCompany/MyGame/bin

cocos compile -s ~/MyCompany/MyGame -p android -m release -o ~/MyCompany/MyGame/bin

cocos compile -s c:MyCompanyMyGame -p win32 -m release -o c:MyCompanyMyGamebin

这里的参数有点多,让我们来一个一个说,-p 是编译的平台,-m 是模式:debug 或者 release。如果没指定模式,默认 debug。此外 -s 和 -o 参数是可选的,如果操作命令的当前路径就是工程的路径,那这两个参数都可以省掉。比如已经在 ~/MyCompany/MyGame 目录,那编译命令可以简化为:

cocos compile . -p ios -m release

你也可以增加一个可选的参数 -q,这样执行静默操作,控制台的输出信息会比较少。示例:

cocos compile -q -s ~/MyCompany/MyGame -p ios -m release -o ~/MyCompany/MyGame/bin

由于命令行工具支持很多平台,因此还有一些特定平台的参数,使用它们可以进行更多的控制,比如指定 SDK 版本,确定签名信息,添加一些 Lua 相关或专用于 Web 的选项。

使用命令 cocos compile –help 可以查看更多关于项目编译的帮助信息。

  • Android 项目编译注意事项
    • 命令行工具是很灵活的,对于编译 Android 项目允许开发者使用特定版本的 API。比如你的系统上安装了 Android-22,你想使用它来编译,就在命令行的最后增加参数 –ap android-api-version。示例:
      • cocos compile -p android –ap android-22
    • 你可以在项目的配置中,查看到目标 API 是什么版本。

项目运行

创建完项目后,你可以直接从命令行执行运行命令。cocos 会启动你指定平台的程序。命令行格式如下:

cocos run -s <path to your project> -p <platform>

示例:

cocos run -s ~/MyCompany/MyGame -p ios

cocos run -s ~/MyCompany/MyGame -p android

cocos run -s c:MyCompanyMyGame -p win32

当然,你也可以指定程序以 debug 还是 release 方式运行,默认的方式是 debug。示例:

cocos run -s ~/MyCompany/MyGame -p ios -m release

就好像 cocos compile 命令那样,如果你已经在项目目录了,-s 和 -o 参数就不是必须的,这对 cocos run 命令也一样。就以上面的为例,如果已经在工程目录,命令可以简化成:

cocos run . -p ios -m release

在运行 Web 程序时,还有可选的参数,允许你指定浏览器,例如指定 Google Chrome:

cocos run -s ~/MyCompany/MyGame -p web -b /Applications/Google Chrome.app

cocos run -s ~/MyCompany/MyGame -p web -b C:Program FilesGoogleChromeApplicationchrome.exe

cocos run -s ~/MyCompany/MyGame -p web -b /usr/local/bin/chrome

你还可以指定 IP 地址和端口,更多关于项目运行的使用帮助,请运行 cocos run –help 命令。

项目发布

cocos 通过提供一系列项目发布的命令实现了简单的发布机制。这些命令,就像上面介绍的命令一样,通过一些参数指定需要的操作。命令格式如下:

cocos deploy -s <path to your project> -p <platform> -m <mode>

示例:

cocos deploy -s ~/MyCompany/MyGame -p ios -m release

cocos deploy -s ~/MyCompany/MyGame -p android -m release

cocos deploy -s c:MyCompanyMyGame -p win32 -m release

你可以增加参数 -q,执行静默操作,这样控制台的输出信息会比较少。示例:

cocos deploy -q -s ~/MyCompany/MyGame -p ios -m release

运行 cocos deploy –help,可以查看更多关于项目发布的帮助信息。