配置
环境配置
默认提供三套环境配置,分别为:
yaml
# 通用环境配置
# 平台标题
VITE_APP_TITLE = 金合技术中台
# 浏览器页签图标
VITE_APP_ICON = 'logo.svg'
# 平台LOGO
VITE_APP_LOGO = 'logo.svg'
# iconfont前缀 - 不需要修改
VITE_ICON_SUFFIX = ik
# version
VITE_BUILD_VERSION = 2.0.1
# 是否处于开发框架状态,业务使用时应置为false
VITE_FRAMEWORK = true
yaml
# 示例页面 - 开启后自动追加示例菜单
VITE_OPEN_EXAMPLE = true
# 是否开启代理
VITE_OPEN_PROXY = true
# 代理地址
VITE_APP_PROXY_URL=http://192.168.2.45:8000/
# 接口请求地址 开启代理时 请求地址配置为自己本机IP
VITE_APP_API_BASEURL = http://192.168.1.112:9000/
# 上传地址
VITE_APP_UPLOAD_URL=http://192.168.1.112:9000/server/oss
# 上传资源访问地址
VITE_APP_DOWNLOAD_URL=http://192.168.1.112:9000/server/oss?fileUrl=
# 调试工具,可设置 eruda 或 vconsole,如果不需要开启则留空
VITE_APP_DEBUG_TOOL =
# 监听目录变动 - 用于实时获取目录列表(菜单添加时使用)启用后在新增或删除菜单时会重新生成目录树,建议在新增菜单时开启,长时间不修改目录可以关闭,提升编译性能
VITE_WATCH_FOLDER = false
# 是否在打包时生成 sourcemap
VITE_BUILD_SOURCEMAP = false
yaml
# 接口请求地址,会设置到 axios 的 baseURL 参数上
VITE_APP_API_BASEURL = /api
# 上传地址
VITE_APP_UPLOAD_URL= /api/server/oss
# 上传资源访问地址
VITE_APP_DOWNLOAD_URL= /api/server/oss?fileUrl=
# 调试工具,可设置 eruda 或 vconsole,如果不需要开启则留空
VITE_APP_DEBUG_TOOL =
# 是否在打包时启用 Mock
VITE_BUILD_MOCK = false
# 是否在打包时生成 sourcemap
VITE_BUILD_SOURCEMAP = false
# 是否在打包时开启压缩,支持 gzip 和 brotli,需要服务端配置才会生效(比如nginx需要开启gzip)
VITE_BUILD_COMPRESS = gzip,brotli
其中 VITE_APP_TITLE
VITE_APP_API_BASEURL
VITE_APP_DEBUG_TOOL
为必要配置,即不管是在开发、测试,还是生产环境都需要使用到。而其余配置则在不同环境下有不同用途,例如开发环境用于本地开发使用,测试环境和生产环境用于构建使用。
开发者可根据实际业务需求进行扩展,如果对这块不熟悉,请阅读 Vite - 环境变量和模式 章节。
应用配置(框架配置)
开发者请在 /src/settings.ts
文件中设置自定义配置,而 /src/settings.default.ts
为框架的默认配置,请勿在该文件内修改。
关于配置的类型定义,可以在 /src/types/globals.d.ts
文件中查阅。
ts
// 这是基础版演示源码里的自定义配置示例
const globalSettings: Settings.all = {
app: {
enablePermission: true,
enableDynamicTitle: true,
},
layout: {
enableMobileAdaptation: true,
},
menu: {
enableSubMenuCollapseButton: true,
enableHotkeys: true,
},
topbar: {
mode: 'fixed',
},
toolbar: {
enableFullscreen: true,
enablePageReload: true,
enableColorScheme: true,
enableAppSetting: true,
},
}