cip-components/migration/v3.x.md

v3.x迁移指南

v2.x至v3.x破坏性更新

不支持原有的vuex写入用户数据、菜单、平台名称

处理方案

• 用户信息有components组件提供store
• 菜单数据、平台名称在使用Main组件时再传入
  • 删除main/index.vue中: ?? store.state.app.platformMenu
  • 在项目中给 import CipMain from '@cip/components/main/index.vue' 组件下发数据
• cip-cli主要修改部分
  • 删除项目部分store文件夹
  • render/index.js 删除 vuex 的注册(.use(store))
  • render/auth.js的store引入来源修改为@cip/components/store

移除组件库对@/api文件的依赖

• cip-form-input/basic/file/upload.js 移除内置的默认的文件上传方法 File.upload
  • 原功能由cip-config-provide 的fileUpload属性代替
  • cip-cli主要修改部分
  • App.vue中的添加属性
• cip-form-input/request 文件夹内组件迁移
  • 见 数据字典组件 dataDirectory 迁移
• main/header-bar/index.vue 移除内置的accountService.logout方法
  • 原功能由cip-config-provide 的logout属性代替
  • cip-cli主要修改部分
  • App.vue中的添加属性

数据字典组件 dataDirectory 迁移

• cip-form-input/request/data-directory 迁移至 @cip/plugins/form/form-input/request/data-directory
• cip-cli主要修改部分
  • 若项目中存在 type: 'dataDirectory' 的使用则d-render-config.js修改

export default {
  components: {
    // 加入此行代码 此组件需要@/api及@/api/entity中特定属性的支持具体请查询组件说明
    dataDirectory: (mode) => () => import('@cip/plugins/form/form-input/request/data-directory')
  }
}
// or 【2022-06-28新增】
import dataDictionaryCompMap from '@cip/plugins/form/form-input/request/data-dictionary/component-map'
export default {
  components: {
    // 加入此行代码 此组件需要@/api及@/api/entity中特定属性的支持具体请查询组件说明
    dataDirectory: dataDictionaryCompMap
  }
}

去除styles/variate.less :export部分内容

[2022-06-06] cip-table 暴露table组件实例的方式由原来的instance.ctx修改为expose

• 此修改将导致原来的tableRef.value.cipTableRef.value => 修改为tableRef.value.cipTableRef
  • 若项目中由使用到cipTable的ref去除cipTableRef后面的.value

[2022-06-28] cip-form-item 及 cip-form-input 重构

• 不在支持emit('update:modelValue',xxx)及emit('update:otherValue',xxx)对数据的更新
• 此修改将导致自定义input组件被使用values + updateStream 的方式更新数据
• 去除自定义input组件中的model数据下发
• input数据修改使用 proxyValue 以及 proxyOtherValue
• 【注但即将在下个版本废弃】目前仍兼容emitModelValue及emitOtherValue进行数据的修改

[2022-07-12] cip-dialog confirm 正确的执行完成后的返回结果由true修改为onConfirm resolve 返回的数据

[2022-07-19] cip-form-renderer 暴露组件实例的方式由原来的instance.ctx修改为expose

• 若项目中由使用到cip-form-renderer的ref，expose会自动解构，去除cipFormRef后面的.value