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

    安装和启动

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

    下载 Cocos Creator

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

    下载完成后双击安装包。

    Windows 安装说明

    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 的空间,请在安装前整理您的系统盘空间。

    • 如果出现 “不能安装需要的文件,因为 CAB 文件没有正确的数字签名。可能表明 CAB 文件损坏” 的弹窗警告,请尝试使用管理员权限进行安装。

    • 对于部分很老并且长期处于内网或者很久没有升级操作系统补丁的 Windows 系统,运行时可能会出现一些 dll 缺失引起的相关报错,可尝试安装该系统补丁解决:https://support.microsoft.com/en-us/help/2999226/update-for-universal-c-runtime-in-windows

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

    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 就可以开始使用了。

    注意:如果下载后无法打开,提示 dmg 或者 app 文件已损坏、来自身份不明的开发者或者包含恶意软件等。

    安装和启动 - 图1

    请在 Finder(访达)中右键点击 dmg 或 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 或快捷方式,方便您随时运行使用。

    检查显卡驱动

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

    1. This browser does not support WebGL...

    的报错信息。这是由于编辑器依赖 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 平台的游戏,完成上面的步骤就足够了。如果您希望发布游戏到原生平台,请参考 安装配置原生开发环境