配置文件用于设置当前项目的全局配置, 如静态资源文件根路径, 远程 API 根路径, 调试端口等一系列配置.
配置文件位于项目文件夹的 src/config.js
中, 其结构如下:
var environment = {
// 开发环境独立配置
development: {
apiRoot: 'http://local.xxx.alibaba-inc.com',
},
// 测试环境独立配置
testing: {
apiRoot: 'http://test.xxx.alibaba-inc.com',
},
// 生成环境独立配置
production: {
apiRoot: 'http://xxx.alibaba-inc.com',
}
}[process.env.NODE_ENV || 'development'];
module.exports = Object.assign({
port: 5000,
publicPath: 'http://g.alicdn.com/forest/{name}/{version}',
theme: { cuz: '1.3.5' },
html5Mode: false,
site: {
name: "我的个人站点"
},
}, environment);
其中支持 Key 的详细说明如下表所示:
Key | Type | Default | Description |
---|---|---|---|
port | Number | 5000 | 使用 cuz dev 时启动的调试端口 |
theme | Object | 组件主题样式, 格式为 { themeName: themeVersion }, 配置后将自动加载相应 css 文件 | |
apiRoot | String | (相对路径) | 全局远程 WEB API 路径. 在发送含有相对路径的 AJAX 请求时会加上该路径 |
publicPath | String | (相对路径) | 静态资源文件根路径, 配置后项目中所有使用相对路径的静态资源(包括 js, html, image, font 等)都会加上该路径. 其中 {name} 和 {version} 会读取 package.json 相应字段 |
html5Mode | Boolean | false | 是否启动 HTML5 模式的 URL 路径, 默认为 hash 模式 |
site | Object | 站点相关信息, 格式为 { title: 'site name' } |
environment
中的 development
, testing
, production
分别代表开发环境
, 测试环境
以及生产环境
. 可根据实际情况对其独立配置.
Note:
关于如何在调试时使用不同的环境配置文件, 请参考 cuz-cli.