配置系统
了解 Oiyo 的框架配置和页面全局配置
配置系统是 Oiyo 的能力开关。框架配置决定项目启用哪些能力,页面配置决定全局页面信息如何进入 pages.json。
Oiyo 常用配置分两层:
- 框架配置:
oiyo.config.ts,用于整个框架的功能配置。 - 页面配置:
src/pages.config.ts,用于声明页面的全局配置。
框架配置
默认情况下,Oiyo 内置配置已覆盖大多数常见场景。需要调整时,可以通过 oiyo.config.ts 扩展配置。
defineOiyoConfig() 用于定义框架配置:
oiyo.config.ts
import { defineOiyoConfig } from '@skiyee/oiyo/config'
export default defineOiyoConfig({
scan: {
apis: [
// 配置 API 扫描源
],
components: [
// 配置组件扫描源
],
},
ide: {
// 配置自动打开小程序 IDE
},
exclude: [
// 配置排除文件
],
})
页面配置
definePagesConfig() 用于定义页面全局配置。页面文件中的 definePageMeta() 负责单个页面配置。
src/pages.config.ts
import { definePagesConfig } from '@skiyee/oiyo/config'
export default definePagesConfig({
globalStyle: {
// 配置全局性页面样式
},
tabBar: {
// 配置 TabBar 样式
},
})
pages.config.ts 必须位于 <srcDir> 目录中。