• 引擎定制工作流程
    • 定制 JavaScript 引擎
      • 获取 JS 引擎
      • 安装编译依赖
      • 进行修改然后编译
      • 在 Cocos Creator 中使用定制版引擎
    • 定制 Cocos2d-x 引擎
      • 初始化
      • 在 Cocos Creator 中使用定制版引擎
      • 修改引擎
      • 编译预编译库和模拟器
      • JSB 绑定流程

    引擎定制工作流程

    Cocos Creator 的引擎部分包括 JavaScript 和 C++ 两个部分。全部都在 github 上开源。地址在:

    • Creator-JS 引擎:https://github.com/cocos-creator/engine
    • Cocos2d-x 引擎:https://github.com/cocos-creator/cocos2d-x-lite
      我们建议您通过 github 的 fork 工作流程来维护自己定制的仓库,具体操作方式请阅读 github help: Fork A Repo。关于更多 github 相关工作流程请参考 github help。

    定制 JavaScript 引擎

    如果您仅需要定制 Web 版游戏的引擎功能,或只需要修改纯 JavaScript 层逻辑(如 UI 系统,动画系统),那么您只要按照下面的流程修改 JS 引擎就可以了。

    获取 JS 引擎

    首先您需要从 github 上 clone Creator-JS 引擎的原始(地址见上文)或 fork 后的版本。根据不同的 Creator 版本,还需要 checkout 不同的分支,例如 Creator 1.1.2 对应的是引擎的 v1.1 分支。下载后存放到任意本地路径,在命令行中进入此路径。

    安装编译依赖

    1. # 安装 gulp 构建工具
    2. npm install -g gulp
    3. # 在命令行中进入引擎路径
    4. npm install

    进行修改然后编译

    接下来您可以定制引擎修改了,修改之后请在命令行中执行:

    1. gulp build

    来编译将引擎源码编译到 bin 目录下。

    在 Cocos Creator 中使用定制版引擎

    通过 偏好设置 面板的 原生开发环境 分页设置。设置使用您本地定制后的 JS 引擎路径。

    定制 Cocos2d-x 引擎

    如果您需要定制渲染和原生接口相关的引擎功能,在修改 JS 引擎的基础上,还需要同步修改 Cocos2d-x 的 C++ 引擎。注意 Cocos Creator 使用的 Cocos2d-x 引擎是专门定制的,需要从上文中指定的 github 仓库下载。

    和 JS 引擎类似,C++ 引擎在使用前也请确认当前所在分支,对于 Cocos Creator v1.2.0 版本请使用 v1.2 分支。

    初始化

    下载或克隆好引擎仓库后,在命令行进入引擎路径然后执行:

    1. # 安装编译依赖
    2. npm install
    3. # 下载依赖包,需要提前配置好 python
    4. python download-deps.py
    5. # 同步子 repo,需要提前配置好 git
    6. git submodule update --init

    在 Cocos Creator 中使用定制版引擎

    通过 偏好设置 面板的 原生开发环境 分页设置。设置使用您本地定制后的 Cocos2d-x 引擎路径。

    修改引擎

    接下来您可以对 Cocos2d-x 引擎进行定制了,由于只有在 构建发布 过程中才会编译代码,所以修改引擎后可以直接打开 构建发布 面板,选择 default 项目模板进行构建和编译。

    编译预编译库和模拟器

    如果想在 构建发布 面板中使用 binary 预编译库模板加速编译过程,就需要在 Cocos2d-x 引擎路径下执行:

    1. # 通过 cocos console 生成预编译库
    2. gulp gen-libs

    要在模拟器中预览您的引擎修改,需要执行以下命令来重新编译模拟器

    1. # 通过 cocos console 生成模拟器
    2. gulp sign-simulator
    3. gulp gen-simulator
    4. gulp update-simulator-config

    gulp sign-simulator 是 1.7.0 中的新增命令,只有 Mac 需要运行。详见 Build simulator。

    JSB 绑定流程

    如果您需要在 JavaScript 引擎和 C++ 引擎同步修改内容,应该完成 JSB 绑定。

    1.7 及 1.7 以上版本请参考

    • JSB 2.0 绑定教程
      1.6 及 1.6 以下版本请参考

    • Cocos 中的脚本绑定

    • Cocos 中的自动绑定