快速开始
依赖环境
首先得有 Node.js,推荐 node 版本是 18.18 或以上,尽量不要超过22.x。
# 打印 node 版本
node -v
v18.18.0
推荐使用 yarn 管理 yarn 依赖,当然也可以使用npm、pnpm
# 全局安装 yarn
npm install --global yarn
# 打印 yarn 版本
yarn -v
获取项目
源码地址:https://gitee.com/ice-gl/icegl-three-vue-tres
# 直接下载zip包
https://gitee.com/ice-gl/icegl-three-vue-tres/repository/archive/master.zip
# 或者 git克隆
git clone https://gitee.com/ice-gl/icegl-three-vue-tres.git
# cd 到项目根目录
# 安装依赖
yarn install
若依赖包安装出错
若出现形如:
ERR! network request to ****** failed, reason: connect ETIMEDOUT
或:
ERR! Response timeout while trying to fetch http://****** .....
那么详见 社区解决方案:npm及yarn代理设置及更换为国内下载源 或者直接下载帖子回复的依赖包。
启动和编译
关于一下七种模式的说明:
# 若是您刚了解 icegl-three-vue-tres 那么使用如下 预览调试
# 预览调试 : 包含原生功能和已安装的样例和插件预览模式
yarn pre.dev
# 预览编译 用于预览的展示,给项目参与者和插件开发者使用
yarn pre.build
# 若您已相对了解本项目 那么使用如下 调试自己得工程项目
# 它将专注于您自己构建的项目,只包含您引用的插件相关内容,而不包含与项目无关的路由和插件
yarn dev
# 项目打包:除了自己项目引用的插件部分组件,其余一律不打包,您可以手动去除public不用的素材
yarn build
# 特殊需求:单插件/案例
# 若您只想针对一个案例/插件进行调试,请使用如下命令
yarn pre.dev.one #它只展示某一个案例/插件
# 若您只想针对一个案例/插件进行打包,请使用如下命令
yarn pre.build.one #它针对某一个案例/插件打包,会根据配置下的依赖插件项保留资源,其余资源删除
## ---↓ 以上单插件/案例配置 ↓---
#文件:.env.predev.one 中的
FES_APP_PLSNAME='xxx' #对应的打包插件名
#文件:src\plugins\xxx\config.js 中的
require: ['UIdemo','industry4'] #xxx插件对应依赖的案例/插件名称
## ---↑ 以上单插件/案例配置 ↑---
# 扩展
# 同时启动 dev 和 pre.dev 可以边调试自己得项目,边对照移植样例和插件
yarn both
部署
本地编译打包后,就可以部署了。你需要把 dist 目录部署到服务器上。