跳到主要内容

用户配置

模块是通用代码,类似于一个npm包,我们不应该去直接修改模块里面的一个些代码,因为如果这个模块更新了,要使用这些更新就会很麻烦

配置文件放在configs下,每个文件夹就是一个项目的用户配置,其中index.js就是用户配置文件

此处还会放其他文件 入 duxapp.rn.js 是框架配置文件,一般用于RN端使用,请查看RN用户配置

用户配置文件是一般是这样面这样的

const config = {
// 覆盖app.config.js 配置
appConfig: {},
// 调试配置
debug: {
// 在h5端开启vconsole调试功能
vconsole: false
},
// 模块配置 将会调用模块生命周期的option,将对应模块的参数传入
option: {
// 基础模块
duxapp: {
theme: {
primaryColor: '#CDDE00',
secondaryColor: '#FDD000',
successColor: '#34a853',
warningColor: '#fbbc05',
dangerColor: '#ea4335',
pageColor: '#fafbf8',
mutedColor: '#666',
header: {
color: '#fff', // 仅支持rgb hex值,请勿使用纯单词 设置为数组将显示一个渐变按钮
textColor: '#000', // 文本颜色
showWechat: false, // 微信公众号是否显示header
showWap: true, // h5是否显示header
}
}
},
// ... 其他模块配置
}
}

export default config

配置文件使用

配置文件是如何被使用的呢,在我们运行命令时,例如 yarn dev:weapp --app=duxuiExample,用--app指定的入口模块,将会作为配置名称使用

也就是此时用到的配置文件是 configs/duxuiExample/index.js 但是如果这个配置并不存在,那么他将会使用 configs/default/index.js,作为当前的配置文件

如果你想使用自定义的配置那么还需要在命令上加上 --config=duxuiExampleCustom 参数,像这样

yarn dev:weapp --app=duxuiExample --config=duxuiExampleCustom

此时使用的配置文件将是 configs/duxuiExampleCustom/index.js

绝大多数的命令上面都可以加上 --config 参数用于指定配置文件

基础模块提供配置

某些情况下你可能希望能更快的取得配置参数,而不是等待option的回调函数,duxapp模块导出整个配置文件,名称为 userConfig,按照下面的方法导入使用

inport { userConfig } from '@/duxapp'
信息

这是由cli功能实现的,仅在duxapp模块里导出

参数详解

disablePages

当某些页面不需要编译时,在此处设置将其禁用
其配置和功能和模块路由里面disablePages完全相同

appConfig

这里的配置将会覆盖Taro的app.config.js配置文件

例如你要配置小程序接口权限、小程序插件等,就配置在这个地方

debug

  • vconsole 开启h5端调试功能

option

option字段就是模块配置,每个模块都可能拥有自己不一样的配置,配置之后在每个模块的入口文件导出的 option 处取得这些参数

具体模块提供提供了哪些配置请前往具体模块查看。