OS X Cocos2d-x 环境搭建

2017-02-23 ALEX LIN 更多博文 » 博客 » GitHub »

Cocos2d-x

原文链接 http://chaosky.me/2017/02/23/Cocos2d-x-Install/
注：以下为加速网络访问所做的原文缓存，经过重新格式化，可能存在格式方面的问题，或偶有遗漏信息，请以原文为准。

更新日志

Cocos2d-x 引擎

Cocos2d-x引擎可在 Cocos官网下载，其下载地址为：http://www.cocos.com/download/。当然，亦可从Cocos2d-x的 GitHub 仓库拉取，仓库地址：https://github.com/cocos2d/cocos2d-x。下载完成后，引擎包的主要内容下。 framework_architecture

  • AUTHORS：作者目录，包含所有给Cocos2d-x引擎贡献代码的开发者
  • build：包含测试例子、cocos2d_lib的Xcode以及Visual Studio工程
  • CHANGELOG：所有历史版本详细改动列表
  • CMakeLists.txt：cmake配置文件
  • cocos：Cocos2d-x引擎源代码
  • CONTRIBUTING.md：贡献代码指南
  • docs：包含JavaScript代码风格规范、当前发布说明和当前版本升级指南
  • download-deps.py：下载第三方库的脚本
  • extensions：第三方扩展
  • external：存放第三方库的文件夹
  • licenses：所有许可协议
  • plugin：插件
  • README.cmake：针对cmake用法的说明文件
  • README.md：Cocos2d-x引擎简介
  • setup.py：Cocos Console的安装脚本
  • templates：Cocos Console创建项目时使用的模板
  • tests：各分支的测试项目
  • tools：工具文件夹
  • —bindings-generator：脚本绑定工具
  • —cocos2d-console：Cocos Console工具
  • —tojs：JSB自动绑定配置文件以及生成脚本
  • —tolua：Lua绑定配置文件以及生成脚本
  • web：Cocos2d-JS游戏引擎

<!-- more -->

Cocos Console

Cocos Console 是 Cocos2d-x 引擎下的一个命令行工具，它用来管理 Cocos 工程，其中包含创建、运行、编译、调试以及打包项目等。

Cocos Console 位于引擎包 cocos2d-x/tools/cocos2d-console 目录下，通过运行引擎包目录下的 setup.py 脚本即可安装。在安装的过程中，Cocos Console 需要开发者提供 Android NDK、Android SDK 和 Apache ANT 的文件路径。另外，Cocos Console 是一个采用 Python 语言编写的跨平台脚本工具，所以在安装Cocos Console 之前，需要先安装好Python。

安装 Python

在 Mac OS X 中，操作系统本身自带了 Python，而在 Windows 操作系统中，Python 则需要我们自行下载并安装，其下载地址为：https://www.python.org/downloads/index.html。若你的Mac OS X系统中没有Python，也可通过此地址下载安装。下载至Mac OS X和Windows上的安装包分别是一个.pkg或者.msi文件。

打开终端，输入 python --version。若提示 Python 版本号，则说明 Python 安装成功。

Android 环境配置

当安装好 Python 之后，你便可以开始准备 Android 相关的软件包了。当然，若你不需要支持 Android，除了 Apache Ant 之外，其余步骤可以跳过，不必配置。

  • Apache Ant：将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具，大多用于Java环境中的软件开发。下载地址：http://ant.apache.org/bindownload.cgi。
  • Android SDK：即Software Development Kit的简称，中文译为软件开发工具包。在Android 中，它为开发者提供了库文件以及其他开发所用到的工具。下载地址：。
  • Android NDK：即Native Development Kit的简称，它是一系列工具的集合，可以帮助开发 者快速开发C/C++的动态库。另外，它还能自动将.so文件和Java应用一起打包成.apk。下 载地址：https://developer.android.com/sdk/index.html?hl=sk。
  • JDK：Java的开发工具包，包括Java运行环境、Java工具和Java基础类库。下载地址：https://www.oracle.com/downloads/index.html。

安装 Cocos Console

打开终端，进入 Cocos2d-x 引擎目录下，然后再运行setup.py脚本，相关命令如下：

$ cd /Users/Chaosky/Cocos/cocos2d-x-3.14.1
$ python setup.py

然后根据提示，将Cocos Console所需的文件路径拖曳进去，最后根据末尾行提示进行对应的操作。 ![Jietu20170306-170411]http://7xooko.com1.z0.glb.clouddn.com/2017-03-06-Jietu20170306-170411.png)

此时，Cocos Console安装成功。若要卸载Cocos Console，则Mac OS X用户可删除 /Users/用户名/下.bash_profile或者.zshrc 文件中对应的值，而Windows用户只需删除对应的系统环境变量值即可。

创建、编译和运行工程

在终端中执行 cocos --help，查看 cocos 命令行工具集的功能。

$ cocos --help

可用的命令：
    run              在设备或者模拟器上编译，部署和运行工程。
    gen-libs         生成引擎的预编译库。生成的库文件会保存在引擎根目录的 'prebuilt' 文件夹。
    luacompile       对 lua 文件进行加密和编译为字节码的处理。
    deploy           编译并在设备或模拟器上部署工程。
    package          管理 cocos 中的 package。
    compile          编译并打包工程。
    gen-simulator    生成 Cocos 模拟器。
    new              创建一个新的工程。
    jscompile        对 js 文件进行加密和压缩处理。
    gen-templates    生成用于 Cocos Framework 环境的模板。

可用的参数：
    -h, --help          显示帮助信息。
    -v, --version           显示命令行工具的版本号。
    --ol ['en', 'zh', 'zh_tr']  指定输出信息的语言。

示例：
    cocos new --help
    cocos run --help

创建

终端中输入cocos new --help查看功能。

$ cocos new --help

usage: cocos new [-h] [-p PACKAGE_NAME] [-d DIRECTORY] [-t TEMPLATE_NAME]
                 [--ios-bundleid IOS_BUNDLEID] [--mac-bundleid MAC_BUNDLEID]
                 [-e ENGINE_PATH] [--portrait] [--no-native] -l {cpp,lua,js}
                 [PROJECT_NAME]

创建一个新的工程。

positional arguments:
  PROJECT_NAME          设置工程名称。

optional arguments:
  -h, --help            show this help message and exit
  -p PACKAGE_NAME, --package PACKAGE_NAME
                        设置工程的包名。
  -d DIRECTORY, --directory DIRECTORY
                        设置工程存放路径。
  -t TEMPLATE_NAME, --template TEMPLATE_NAME
                        设置使用的模板名称。
  --ios-bundleid IOS_BUNDLEID
                        设置工程的 iOS Bundle ID。
  --mac-bundleid MAC_BUNDLEID
                        设置工程的 Mac Bundle ID。
  -e ENGINE_PATH, --engine-path ENGINE_PATH
                        设置引擎路径。
  --portrait            设置工程为竖屏。
  -l {cpp,lua,js}, --language {cpp,lua,js}
                        设置工程使用的编程语言，可选值：[cpp |
                        lua | js]

lua/js 工程可用参数:
  --no-native           设置新建的工程不包含 C++
                        代码与各平台工程。

具体有几种方式：

  1. 创建一个名为projectName，并同时包含Cocos2d-HTML5和Cocos2d-x JSB项目

    cocos new projectName -l js

  2. 创建一个名为projectName，且仅含Cocos2d-HTML5的项目， --no-native表示不需要支持Native平 台（iOS、Android、Mac、Windows等），仅支持浏览器即可

    cocos new projectName -l js --no-native

  3. 在桌面上创建一个名为projectName的项目

    cocos new projectName -l js -d ./Desktop

  4. 在桌面上创建一个名为projectName的项目，并设置为竖屏

    cocos new projectName -l js -d ./Desktop --portrait

其中 -l 表示采用的语言，可选值为 cpp、lua以及js。

编译、部署、运行

当项目创建完毕后，可以通过下列命令将项目运行在浏览器中：

cd ./Desktop/HelloWorld cocos run -p web

除创建命令外，Cocos Console还为工程提供了运行、编译等命令，具体如下：

// 运行在指定的平台上
cocos run -p web|ios|android|mac|win32
// 将项目工程打包到指定的平台上
cocos compile -p web|ios|android|mac|win32 -m release

Cocos Console提供了相关的help指令，方便开发者查询Cocos Console相关的指令。下面举几个 help指令的例子，其中help可用字母h替代：

cocos new --help
cocos run --help
cocos compile --help