# cocos-plugin-import-2.x

**Repository Path**: cocos/cocos-plugin-import-2.x

## Basic Information

- **Project Name**: cocos-plugin-import-2.x
- **Description**: plugin for migrating cocos creator 2.x projects.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2022-06-05
- **Last Updated**: 2022-11-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# plugin-import-2.x

[English](https://github.com/cocos-creator/plugin-import-2.x/blob/main/readme/README.en.md)

[Cocos Creator 3.0 升级指南](https://github.com/cocos-creator/creator-docs/blob/v3.0/zh/release-notes/upgrade-guide-v3.0.md)

该插件用于减少开发者升级 v2.x 项目到 v3.0.0 的工作量。

由于目前编辑器无法支持插件热更新，所以如果开发者在使用该插件时遇到问题，通过下方教程去更新插件，从而能够快速解决问题，无需等待编辑器版本更新。

## 如何更新插件

1. 下载：
    - 最新: 
        - 支持粒子中 textureUuid 字段迁移
        - 修复 v2.x 迁移到 v3.0.0 之后，按钮不可点击的问题
        - 修复解析 ts 脚本类名丢失的问题
        - 修复动画剪辑中 SpriteFrame 丢失的问题
        - 修复组件 ProgressBar 数据丢失的问题
        - 修复 v2.x 含有 StudioWidget 组件升级后导致场景报错的问题
        - 修复脚本升级 property 没有设置类型的问题
        - 修复动画剪辑中 scale 为 0 时，数据解析错误的问题
        - 修复 Layout resizeMode 数据丢失的问题
        - 修复迁移摄像机 alignWithScreen 属性错误的问题
        - 修复解析 js 中 getset 格式错误的问题
            - [点击下载最新版本](https://github.com/cocos-creator/plugin-import-2.x/releases/download/main/importer.zip)

2. 存放到相关指定位置，如下
    - 应用于全局（所有项目）下，只需要将插件文件夹存放到 **用户/.CocosCreator/extensions** 下
    - 应用于单个项目下，只需要将文件夹存放到与 **assets** 文件同级的 **extensions** 文件夹下

> **注意**: 如果没有 **extensions** 文件夹，需要自行创建一个

3. 启用插件
    
    1.通过主菜单打开插件管理器
    
    <img src="https://user-images.githubusercontent.com/7564028/114006756-49c20a80-9893-11eb-8744-30215330a10b.png"/>
    
    2.点击刷新按钮
    
    <img style="margin-left: 84px" src="https://user-images.githubusercontent.com/7564028/114006766-4c246480-9893-11eb-9f46-b0fe03c2c09b.png"/>
    
    3.启用插件
    
    <img style="margin-left: 110px" src="https://user-images.githubusercontent.com/7564028/114006763-4b8bce00-9893-11eb-88ba-e39e3d00a22a.png"/>
    
> **注意**: 如果出现 2 个菜单的话，重启编辑器即可。（该问题是已知问题，后续会修复）

## 如何反馈问题

1. [新建 **New issue**](https://github.com/cocos-creator/plugin-import-2.x/issues/new) 
2. [论坛](https://forum.cocos.org/c/Creator)

如果现有项目因为特殊原因需要升级，并且遇到了技术上或者工作量上的困难，也可以联系 `zhengxiong.zhao@cocos.com` 获取我们的人工协助！