项目采用 vue3+webpack5,vue3 以更好地解决响应式数据问题,在非复杂的模块中,仍然可以使用 vue2 语法编写组件。
需要修改构建相关配置时,请修改 vue.config.js 文件。
多页面支持
:默认为单页面,当需要开启多页面时,可以开启 Multiple pages 部分,当开启了多页面时,请注释 html-webpack-plugin 部分内容。跨域代理
:跨域代理部分请修改配置中 Proxy 部分。静态资源路径
:当部署到线上时,根据需要修改.env.production
中STATIC_PATH
repo
:当项目部署为本地一个域名下子路径时,使用/项目名称
(package.json 中的 name)作为根路径root
:当项目使用独立域名,并引用本地文件时cdn
: 当前项目的静态资源使用 cdn 路径
样式扩展
:默认引用common库 global.less,同时引入本地 css/var.less,用于定义公共全局变量或项目级全局变量。项目设置
:业务型项目设置请统一填写在project.json
中。伪静态
:当页面有锚点需求时,请修改路由为 history 模式,在一般情况下也总是推荐如此,对应根据实际情况修改 base 值与服务器端规则。
- 🌈 修改 package.json 中的 name 字段为项目名称
- 🌈 指定 .github/workflows/build.yaml 中的
$project
为项目名称 - 🌈 指定 .env 中的
STATIC_PATH
- 🌈
npm install
安装依赖(首次/必要时) - 🌈
npm run update
更新公共库依赖(必要时) - ✨
npm run serve
启动本地服务 - ✨
npm run build
测试构建
默认使用 github actions 进行构建,见build.yaml
默认使用 actions 构建,会自动部署在 dist 分支。
- 如为私有仓库且 github 没有开通付费,请自行给每个项目添加
ACCESS_TOKEN
,需要赋予 token workflow 权限。 - 如自行在本地构建,请参考私有包安装指南进行构建环境的 npm registry 配置。
主机部署见监控平台
全站 CDN 默认同时会将构建文件部署至阿里云 OSS/deepberry。
- 请修改配置中 oss 的部署路径,将
$project
修改为项目名(package.json 中的 name)。 - 必要时,请将 DNS CNAME 指向 CDN(需配置证书),CDN 回源至 OSS,映射整个 Bucket 即可。