引擎定制工作流程
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 分支。下载后存放到任意本地路径,在命令行中进入此路径。
安装编译依赖
# 安装 gulp 构建工具
npm install -g gulp
# 在命令行中进入引擎路径
npm install
进行修改然后编译
接下来您可以定制引擎修改了,修改之后请在命令行中执行:
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
分支。
初始化
下载或克隆好引擎仓库后,在命令行进入引擎路径然后执行:
# 安装编译依赖
npm install
# 下载依赖包,需要提前配置好 python
python download-deps.py
# 同步子 repo,需要提前配置好 git
git submodule update --init
在 Cocos Creator 中使用定制版引擎
通过 偏好设置 面板的 原生开发环境 分页设置。设置使用您本地定制后的 Cocos2d-x 引擎路径。
修改引擎
接下来您可以对 Cocos2d-x 引擎进行定制了,由于只有在 构建发布 过程中才会编译代码,所以修改引擎后可以直接打开 构建发布 面板,选择 default
项目模板进行构建和编译。
编译预编译库和模拟器
如果想在 构建发布 面板中使用 binary
预编译库模板加速编译过程,就需要在 Cocos2d-x 引擎路径下执行:
# 通过 cocos console 生成预编译库
gulp gen-libs
要在模拟器中预览您的引擎修改,需要执行以下命令来重新编译模拟器
# 通过 cocos console 生成模拟器
gulp sign-simulator
gulp gen-simulator
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 中的自动绑定