启用配置

本章节将介绍如何在项目中启用全局配置项

开发环境

1、下载最新的 Hbuilder X 正式版 开发者工具。
2、通过 uni_modules 的形式进行安装，此安装方式可以方便您后续在 uni_modules 对组件库进行一键升级。

重要提示

当前插件为 UCS 系列组件库的基础集成配置库，安装组件库时已经自动为其安装， 所以如果项目下的 uni_modules/ucs-config 存在，则无需额外进行安装。

安装地址

插件地址：ucs-config 全局配置

温馨提示

在uni-app插件市场右上角选择 “ 下载插件并导入HBuilderX ”，导入到对应项目中即可。

启用全局配置

在项目根目录下创建 ucsDefineConfig.uts 文件，再将创建的文件在 main.uts 或 main.js 中引入，接下来在 ucsDefineConfig.uts 中进行全局配置的定义。

说明：ucsDefineConfig.uts 文件并不是创建文件固定名称，开发者也可自行定义这个配置文件名称，与引用同步一致即可。

步骤一：创建配置文件

uni-ucs-design
	├─ pages
	├─ static
	├─ uni_modules
	│  └─ ucs-config              # 第一步：查看是否存在全局配置库，如果不存在则导入全局配置库
	├─ App.uvue / App.vue
	├─ index.html
	├─ main.uts / main.js
	├─ index.html
	├─ manifest.json
	├─ pages.json
	├─ ucsDefineConfig.uts         # 第二步：创建 ucsDefineConfig.uts 文件
	└─ uni.scss

ucsDefineConfig.uts 文件内容

import { defineConfig } from "@/uni_modules/ucs-config";

defineConfig({
	// 配置项内容
	
});

步骤二：引入配置文件

uni-app-x项目main.uts

import App from './App.uvue'
import { createSSRApp } from 'vue'

// 引用配置文件
import "./ucsDefineConfig.uts"; 

export function createApp() {
	const app = createSSRApp(App)
	return {
		app
	}
}

uni-app项目main.js

import App from './App'
import { createSSRApp } from 'vue'

// 引用配置文件
import "./ucsDefineConfig.uts"; 

export function createApp() {
	const app = createSSRApp(App)
	return {
		app
	}
}