• 安装和启动
    • 下载 Cocos Creator
      • Windows 安装说明
      • Mac 安装说明
      • 操作系统要求
    • 运行 Cocos Creator
      • 禁用 GPU 加速
    • 使用 Cocos 开发者帐号登录
    • 版本兼容性和回退方法
    • 原生发布相关配置

    安装和启动

    如果阅读此文档时您还没有下载和启动 Cocos Creator,请按照以下步骤开始。

    下载 Cocos Creator

    您可以通过访问 Cocos Creator 产品首页 上的下载链接获得 Cocos Creator 的安装包。

    下载完成后双击安装包。

    Windows 安装说明

    从 v1.3.0 开始,Windows 版 Cocos Creator 将不提供 32 位操作系统支持。

    Windows 版的安装程序是一个 .exe 可执行文件,通常命名会是 CocosCreator_vX.X.X_20XXXXXX_setup.exe,其中 vX.X.X 是 Cocos Creator 的版本号,如 v1.2.2,后面的一串数字是版本日期编号。

    注意 日期编号在使用内测版时会更新的比较频繁,注意如果当前 PC 上已安装的版本号和安装包的版本号相同时,无法自动覆盖安装注意相同版本号的安装包,需要先卸载之前的版本才能继续安装。

    应用的安装路径默认选择了 C:\CocosCreator,可以在安装过程中进行指定。

    Cocos Creator 将会占据系统盘中大约 1.25 GB 的空间,请在安装前整理您的系统盘空间。

    注意:如果出现安装失败,请尝试通过命令行执行安装程序:

    1. CocosCreator_v1.2.0_2016080301_setup.exe /exelog "exe_log.txt" /L*V "msi_log.txt"

    用以下命令执行,或为安装程序创建一个快捷方式,并将该命令行参数填入快捷方式的 目标 属性中。然后将生成的安装日志(exe_log.txtmsi_log.txt)提交给开发团队寻求帮助。

    Mac 安装说明

    Mac 版 Cocos Creator 的安装程序是 DMG 镜像文件,双击 DMG 文件,然后将 CocosCreator.app 拖拽到您的 应用程序 文件夹快捷方式,或任意其他位置。然后双击复制出来的 CocosCreator.app 就可以开始使用了。

    注意:如果初次运行时出现下载的应用已损坏的提示,请前往并设置 系统偏好设置->安全性与隐私->允许任何来源的应用,首次打开后您可以马上恢复您的安全与隐私设置。

    操作系统要求

    Cocos Creator 所支持的系统环境是:

    • Mac OS X 所支持的最低版本是 OS X 10.9。
    • Windows 所支持的最低版本是 Windows 7 64位。

    运行 Cocos Creator

    在 Windows 系统,双击解压后文件夹中的 CocosCreator.exe 文件即可启动 Cocos Creator。

    在 Mac 系统,双击解压后的 CocosCreator.app 应用图标即可启动 Cocos Creator。

    您可以按照习惯为入口文件设置快速启动、Dock 或快捷方式,方便您随时运行使用。

    禁用 GPU 加速

    对于部分 windows 操作系统和显卡型号,可能会遇到

    1. This browser does not support WebGL...

    的报错信息,是显卡驱动对编辑器 WebGL 渲染模式的支持不正确导致的,如果出现这种情况,可以尝试使用命令行运行 CocosCreator.exe 并加上 --disable-gpu 运行参数,来禁用 GPU 加速功能,可以绕开部分显卡驱动的问题。

    使用 Cocos 开发者帐号登录

    如果您不需要发布游戏到原生平台,以上的两步简单操作就能为您准备好使用 Cocos Creator 制作游戏的一切开发环境。

    Cocos Creator 启动后,会进入 Cocos 开发者帐号的登录界面。登录之后就可以享受我们为开发者提供的各种在线服务、产品更新通知和各种开发者福利。

    如果之前没有 Cocos 开发者帐号,您可以使用登录界面中的 注册 按钮前往 Cocos 开发者中心进行注册。或直接使用下面的链接:

    https://passport.cocos.com/auth/signup

    注册完成后就可以回到 Cocos Creator 登录界面完成登录了!验证身份后,我们就会进入 Dashboard 界面。除了手动登出或登录信息过期,其他情况下都会用本地 session 保存的信息自动登录。

    版本兼容性和回退方法

    Cocos Creator 版本升级时,新版本的编辑器可以打开旧版本的项目,但当您在项目开发到一半时升级新版本的 Cocos Creator 时也可能会遇到一些问题。因为在早期版本中引擎和编辑器的实现可能存在 bug 和其他不合理的问题,这些问题可以通过用户项目和脚本的特定使用方法来规避,但当后续版本中修复了这些 bug 和问题时就可能会对现有项目造成影响。

    在发现这种版本升级造成的问题时,除了联系开发团队寻求解决办法,您也可以卸载新版本的 Cocos Creator 并重新安装旧版本。安装旧版本过程中可能遇到的问题有:

    • [Windows] 您可能会遇到安装旧版本时提示「已经有一个更新版本的应用程序已安装」的提示,如果确定已经通过控制面板正确卸载了新版本的 Cocos Creator 还不能安装旧版本,可以访问 微软官方解决无法安装或卸载程序 的帮助页,按照提示下载小工具并修复损坏的安装信息,即可继续安装旧版本了。
    • 使用新版本 Cocos Creator 打开过的项目,在旧版本 Cocos Creator 中打开可能会遇到编辑器面板无法显示内容的问题,可以尝试选择主菜单中的「布局->恢复默认布局」来进行修复。

    原生发布相关配置

    如果您只想开发 Web 平台的游戏,完成上面的步骤就足够了。如果您希望发布游戏到原生平台,请阅读相关开发环境的设置说明 安装配置原生开发环境


    继续前往 使用 Dashboard 说明文档。