Skip to content

配置

环境配置

默认提供三套环境配置,分别为:

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,
  },
}