导入其他编辑器项目

简介

通过 Cocos Creator 主菜单中的 文件 -> 导入项目 子菜单，可以导入其他编辑器中的项目。目前支持导入的编辑器项目有：

• Cocos Studio 项目（*.ccs 文件）
• Cocos Builder 项目（*.ccbproj 文件）

相应的菜单项如图：

操作步骤说明

导入其他编辑器项目的操作步骤如下：

1. 点击相应的菜单，选择要导入的项目类型，打开文件选择对话框。

2. 选择对应扩展名的文件：

   

3. 导入过程中 Cocos Creator 的控制台窗口会持续输出 log 以显示当前的导入进度。如下图：

   

   输出的 log 说明：

   • 首先输出导入的工程文件全路径。
   • 中间持续输出正在导入的文件。
   • 当导入完成时，会输出 Import XXX project finished. 的 log。（其中 XXX 为项目所用编辑器名称）
   • 最后输出资源导入后所在的 url。

注意：导入项目所需的时间长短取决于项目大小。在导入过程中请勿在 Cocos Creator 中执行其他操作，耐心等待导入完成。

Cocos Studio 项目导入说明

实现方案

• Cocos Studio 工程中的 csd 文件分为以下三类：

  • Scene —— 导入为场景文件（.fire）
  • Layer —— 导入为 prefab
  • Node —— 导入为 prefab

• csd 文件中记录的节点帧动画数据，导入为 anim 文件。

• 导入后的目录结构：

  • Cocos Studio 工程导入后存放在 assets 目录下一个独立的文件夹中（文件夹以 Cocos Studio 工程名命名）。
  • Cocos Studio 工程中使用的资源文件以相同的目录结构导入到 Cocos Creator 工程中。
  • csd 文件中的帧动画数据存放在一个子目录中，子目录命名为 [csd 文件名]_action

• 目前 Cocos Studio 工程的部分控件在 Cocos Creator 中暂不支持。这些控件在导入过程中，会在相应的节点上添加 StudioComponent 组件，并将控件数据保存在 StudioComponent 组件中。不支持的控件类型包括：

  • 复选框
  • 艺术数字
  • 滑动条
  • 列表容器
  • 翻页容器

• StudioComponent 组件数据如下图：

  

  1. 组件的类型，对应于 Studio 中的控件。
  2. 控件数据，不同的类型显示相应的数据。

目前不支持的情况

• 不支持导入骨骼动画数据。
• 不支持导入 csi 文件（对应的图片以碎图的形式导入，而不是合图）
• 不支持节点的 SkewX 和 SkewY 属性，以及相应的动画。
• Particle 不支持 Blend Function 属性，同时 Sprite 和 Particle 的动画编辑中也不支持 Blend Function 属性的动画。

特别说明

Cocos Studio 项目导入功能是基于 Cocos Studio 3.10 版本进行开发与测试的。如果要导入旧版本的项目，建议先使用 Cocos Studio 3.10 版本打开项目。这样可以将项目升级到对应版本，然后执行导入操作。

• 新支持动画帧事件

  统一添加默认的 triggerAnimationEvent 事件，参数为下方设置的数据：

  

• 导入嵌套的 csd

  当 csd 包含嵌套的时候，会自动创建一个带有 cc.StudioComponent.PlaceHolder 组件的节点来替代。该组件中的 nestedPrefab 属性会存储嵌套的 prefab 资源，并在项目运行后创建该 prefab 来替换当前节点。（必须是 运行时 才可以对该节点进行操作，且目前不支持在编辑器中预览）

  注意：从 v2.4.3 开始不需要再执行该操作。

Cocos Builder 项目导入说明

实现方案

• 所有的 ccb 文件都导入为 prefab。
• ccb 文件中的帧动画数据，导入为 anim 文件。
• 导入后的目录结构参考 Cocos Studio 项目导入的实现。

目前不支持的情况

• CCControlButton 可以设置不同状态下文本的颜色，Cocos Creator 不支持
• 不支持渐变色的 Layer 节点
• 不支持节点的 skew 属性以及动画