SmartPortal项目

目录结构

1. assemble 门户组件在线预览，配置调试项目
2. bundler 通用组件打包工程，适配vue2、vue2.7、vue3
3. docs 文档说明，项目搭建说明，API使用
4. packages 公共工具类、组件、图片库等
5. platform 平台调试项目，组件调试，排查问题所用，含vue2，vue2.7，vue3环境

依赖安装

pnpm install
或
npm run install-all

项目启动

// 启动调试项目vue2环境
pnpm run start:platform-vue2

// 启动调试项目vue2.7环境
pnpm run start:platform-vue2.7

// 启动调试项目vue3环境
pnpm run start:platform-vue3

// 启动说明文档项目
pnpm run start:docs

// 启动组件在线预览项目
pnpm run start:assemble

开发与调试

• 组件本地开发以vue3环境运行，vue2和vue2.7使用本地打包文件调试验证功能是否正常

• 兼容Vue2语法，props一级类型需在组件内定义，不可从Types类型文件引入使用

• 兼容Vue2语法，General组件慎用watchEffect API，可能会在Vue2环境项目死循环导致组件加载失败

• 兼容Vue2语法，General组件的css不可使用v-bind语法（Composition组件可使用v-bind）

• 兼容Vue2语法，全局主题皮肤使用:style注册动态样式，css使用var注入（Composition组件可使用v-bind）

常见问题

• 部分vue2.x项目使用本地打包的文件调试时eslint报错， 解决：注释掉.eslintrc.js文件extends下的'@vue/standard'配置

发布打包

// 打包通用bundler子包
pnpm run build:bundler

// 打包utils工具类子包
pnpm run build:utils

// 打包components组件库子包
pnpm run build:components

// 打包说明文档子包
pnpm run build:docs

发布过程

1. 切换镜像源

nrm use npm
（未安装nrm的执行 npm install nrm -g 即可）

2. 登录

npm login

3. 执行发布

npm publish
或
npm publish --access public

4. 发布问题记录

（1）proxy ETIMEDOUT 超时问题
新增proxy并执行发布命令
npm set proxy http://127.0.0.1:7890(个人代理网络)
npm publish

PS：删除proxy指令：npm config rm proxy

（2）......