微信小程序/小游戏发布助手（mp-ci）

Cocos2d-x 是一套开源、跨平台的 2D 游戏开发框架，主要用于构建 2D 游戏、交互式电子书、演示程序以及其他图形类应用。它源自 cocos2d-iphone，但把实现语言从 Objective-C 换成了 C++，因此可以在 iOS、Android、macOS、Windows 与 Linux 上运行。

按照 README 的说明，Cocos2d-x 的核心已经演进为 Cocos Creator 1.x 与 2.x 的基础。官方在文档末尾也明确表示：不再建议新用户从 Cocos2d-x 起步，而是推荐使用新一代的 Cocos Creator 进行项目开发，以获得更完整的编辑器与 3D 支持。因此，这个仓库更适合作为了解 Cocos 技术谱系、维护既有项目或研究 C++ 游戏框架实现的参考。

README 用四个词概括了它的定位：快速、免费、易用、有社区支持。

技术要点

从 README 可以确认的技术信息包括：

• 主语言为 C++，同时通过绑定层支持 Lua 与 JavaScript 脚本开发；创建新项目时可用 -l cpp 或 -l lua 指定语言。
• 渲染层基于 OpenGL ES 2.0 / OpenGL 2.1，并在 Apple 平台引入 Metal 支持。
• 物理通过集成 Box2D 与 Chipmunk 提供，而非自研物理模块。
• 动画方面同时覆盖帧动画相关的精灵体系与 Spine、Armature 骨骼动画。
• 工程组织上，仓库依赖子模块与额外依赖包，克隆后需要先执行依赖下载脚本。

README 还提到，cpp-tests 项目是官方用于测试的基础工程，位于 cocos2d-x_root/build，可以作为学习引擎功能实现方式的入口。

构建与运行

获取代码与依赖

README 给出的 Git 用户操作步骤如下：

1. 从 GitHub 克隆仓库：

   $ git clone https://github.com/cocos2d/cocos2d-x.git
   

2. 进入目录后执行 download-deps.py 下载并安装依赖：

   $ cd cocos2d-x
   cocos2d-x $ python download-deps.py
   

3. 依赖下载完成后初始化子模块：

   cocos2d-x $ git submodule update --init
   

构建环境要求

README 列出的构建要求包括：

• macOS 10.7+ 与 Xcode 8+；或 Ubuntu 14.04+ 与 CMake 3.1+；或 Windows 7+ 与 VS 2015；
• Python 2.7.5+（明确注明不是 Python 3）；
• 构建 Android 游戏需要 NDK r16+，以及 Android Studio 3.0.0+；
• Web 发布需要 JRE 或 JDK 1.6+。

运行时要求

• iPhone / iPad 游戏：iOS 8.0+；
• Android：Android 3.0.0+；
• Mac 游戏：OS X v10.9+；
• Windows 游戏：Windows 7+。

环境配置与运行测试

在开始新游戏或运行测试前，需要先配置环境：

$ cd cocos2d-x
$ ./setup.py
$ source FILE_TO_SAVE_SYSTEM_VARIABLE

Linux 系统还需额外执行 ./install-linux-deps.sh。

运行测试的命令为：

$ cd cocos2d-x
$ mkdir build
$ cd build
$ cocos run --proj-dir .. -p [mac|win32|android|linux|ios]

创建新项目

$ cd cocos2d-x
$ ./setup.py
$ source FILE_TO_SAVE_SYSTEM_VARIABLE
$ cocos new MyGame -p com.your_company.mygame -l cpp -d NEW_PROJECTS_DIR
$ cd NEW_PROJECTS_DIR/MyGame
$ mkdir build
$ cd build
$ cocos run --proj-dir .. -p [mac|win32|android|linux|ios]

若需要调试，README 建议使用 IDE：除 Android 外的平台都可以用 CMake 生成对应工程文件，具体可参考仓库中的 CMake 指南；Android 的 Android Studio 工程位于 PROJECT_DIR/proj.android，可直接导入。