• 引擎定制工作流程
    • 1、定制 JavaScript 引擎
      • 1.1、获取 JS 引擎
      • 1.2、安装编译依赖
      • 1.3、进行修改然后编译
      • 1.4、在 Cocos Creator 中使用定制版引擎
    • 2、定制 Cocos2d-x 引擎
      • 2.1、获取 Cocos2d-x 引擎
      • 2.2、初始化
      • 2.3、在 Cocos Creator 中配置定制版引擎
      • 2.4、修改引擎
      • 2.5、编译预编译库和模拟器
    • 3、JSB 绑定流程

    引擎定制工作流程

    Cocos Creator 的引擎部分包括 JavaScript 和 Cocos2d-x 两个部分。全部都在 github 上开源。地址在：

    • JavaScript 引擎：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。

    1、定制 JavaScript 引擎

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

    1.1、获取 JS 引擎

    如果您仅需基于当前的版本做一些调整，那么在 Cocos Creator 内置的引擎基础上修改就可以了。点击 Creator 编辑器右上方的 打开程序安装路径，然后将内置的 engine 目录拷贝到本地其他路径。

    引擎定制工作流程 - 图1

    如果您想获得官方正在开发中的最新版本，首先您需要从 github 上 fork 或者克隆 JavaScript 引擎的原始版本（地址见上文）。根据不同的 Creator 版本，还需要切换不同的分支，例如 Creator 1.6.2 对应的是引擎的 v1.6 分支，下载后存放到任意本地路径。

    引擎定制工作流程 - 图2

    1.2、安装编译依赖

    1. # 在命令行中进入引擎路径
    2. cd /Users/yufang/engine
    3. # 安装 gulp 构建工具
    4. npm install -g gulp
    5. # 安装依赖的模块
    6. npm install

    1.3、进行修改然后编译

    接下来您可以定制引擎修改了，修改之后请在命令行中继续执行：

    1. gulp build

    该命令会在引擎目录下生成一个 bin 文件夹，并将引擎源码编译到 bin 目录下。

    引擎定制工作流程 - 图3

    1.4、在 Cocos Creator 中使用定制版引擎

    通过 项目 -> 项目设置 面板的 自定义引擎 选项卡，设置本地定制后的 JavaScript 引擎路径。

    引擎定制工作流程 - 图4

    2、定制 Cocos2d-x 引擎

    如果您需要定制渲染和原生接口相关的引擎功能，在修改 JS 引擎的基础上，还需要同步修改 Cocos2d-x 引擎。

    2.1、获取 Cocos2d-x 引擎

    如果您仅需要基于当前的版本做一些调整，那么在 Cocos Creator 内置的 Cocos2d-x 引擎基础上修改就可以了。操作步骤和获取 JS 引擎一致：点击 Creator 编辑器右上方的 打开程序安装路径，然后将内置的 cocos2d-x 目录拷贝到本地其他路径。

    如果您想取得官方正在开发中的最新版本，需要从上文中指定的 github 仓库下载。和 JS 引擎类似，Cocos2d-x 引擎在使用前也请确认当前所在分支，例如 Cocos Creator v1.6.2 版本请使用 v1.6 分支。

    2.2、初始化

    下载或者克隆好 Cocos2d-x 引擎仓库后，在命令行进入引擎路径然后执行：

    1. # 在命令行进入 Cocos2d-x 引擎路径
    2. cd /Users/yufang/cocos2d-x-lite  
    3. # 安装编译依赖
    4. npm install
    5. # 安装 gulp 构建工具
    6. npm install -g gulp
    7. # 初始化仓库
    8. gulp init

    • 如果遇到类似下方这样的报错，请手动下载该 zip 文件。出错原因是您的 python 自带的一个库版本太低，但是不太好升级，比较简单一些的方法是下载该 zip 文件，手动放到 Cocos2d-x 引擎仓库下并重命名为 v3-deps-54.zip（不需要解压该 zip 文件），再重新运行 gulp init。

      1. > ==> Ready to download 'v3-deps-54.zip' from
      2. > 'https://github.com/cocos-creator/cocos2d-x-lite-external/archive/v3-deps-54.zip'
      3. > Traceback (most recent call last):
      4. > ...
      5. > URLError: <urlopen error [SSL: TLSV1_ALERT_PROTOCOL_VERSION] tlsv1 alert protocol version (_ssl.c:590)>

    • 若遇到类似下方这样的报错，请手动下载该 zip 文件。手动放到 Cocos2d-x 引擎仓库 tools/cocos2d-console 目录下并重命名为 creator-console-2.zip（不需要解压该 zip 文件），再重新运行 gulp init。

      1. > ==> Ready to download 'creator-console-2.zip' from
      2. > 'https://github.com/cocos2d/console-binary/archive/creator-console-2.zip'
      3. > Traceback (most recent call last):
      4. > ...
      5. > URLError: <urlopen error [SSL: TLSV1_ALERT_PROTOCOL_VERSION] tlsv1 alert protocol version (_ssl.c:590)>

    2.3、在 Cocos Creator 中配置定制版引擎

    通过 项目 -> 项目设置 面板的 自定义引擎 选项卡，设置使用您本地定制后的 Cocos2d-x 引擎路径。

    引擎定制工作流程 - 图5

    2.4、修改引擎

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

    2.5、编译预编译库和模拟器

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

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

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

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

    注意：如果需要在 Mac 上通过 Safari 来调试模拟器中的 JavaScript 代码，则需要在生成自定义模拟器之前先在 Xcode 中随便设置一个签名。详见 Build simulator。

    引擎定制工作流程 - 图6

    3、JSB 绑定流程

    如果您需要在 JavaScript 引擎和 Cocos2d-x 引擎同步修改内容，应该完成 JSB 绑定。

    1.7 及 1.7 以上版本请参考

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

    • Cocos 中的脚本绑定

    • Cocos 中的自动绑定

    原文: http://docs.cocos.com/creator/1.10/manual/zh/advanced-topics/engine-customization.html